.. _es-guide-reference-query-dsl-range-query:

===========
Range Query
===========

Matches documents with fields that have terms within a certain range. The type of the Lucene query depends on the field type, for **string** fields, the **TermRangeQuery**, while for number/date fields, the query is a **NumericRangeQuery**. The following example returns all documents where **age** is between **10** and **20**:


.. code-block:: js


    {
        "range" : {
            "age" : { 
                "from" : 10, 
                "to" : 20, 
                "include_lower" : true, 
                :ref:`include_upper <es-guide-reference-query-dsl>`  er <es-guide-reference-query-dsl>`  false, 
                "boost" : 2.0
            }
        }
    }


The **range** query top level parameters include:


=====================  ==============================================================================
 Name                   Description                                                                  
=====================  ==============================================================================
 **from**               The lower bound. Defaults to start from the first.                           
 **to**                 The upper bound. Defaults to unbounded.                                      
 **include_lower**      Should the first from (if set) be inclusive or not. Defaults to **true**     
 **include_upper**      Should the last to (if set) be inclusive or not. Defaults to **true**.       
 **gt**                 Same as setting **from** to the value, and **include_lower** to **false**.   
 **gte**                Same as setting **from** to the value,and **include_lower** to **true**.     
 **lt**                 Same as setting **to** to the value, and **include_upper** to **false**.     
 **lte**                Same as setting **to** to the value, and **include_upper** to **true**.      
 **boost**              Sets the boost value of the query. Defaults to **1.0**.                      
=====================  ==============================================================================