RangeFilter document (Data API 18.6)

Document representing a range filter.

A range filter allows you to restrict a search result to hits that have values for a given attribute that fall into a given value range. The range filter supports several value types and relies on the natural sorting of the value type for range interpretation. Value ranges can be open ended (at one end only). It is configurable whether the lower and/or the upper bound is inclusive or exclusive.

A range filter is useful for general restrictions that can be shared between searches (like a static date range) as the filter result is cached in memory. Range filters are not appropriate if the range is expected to be different for every single query (like if the user controls the date range down to the hour via some UI control). Range filters are inclusive by default.

Example: ( redemption_count BETWEEN (0,10] )

    query: {
        filtered_query: {
            query: { match_all_query: {} },
            filter: {
                range_filter: {
                    field: "redemption_count",
                    from: 0,
                    to: 10,
                    from_inclusive: false
                }
            }
        }
    }