Fuzzy query

Returns documents that contain terms similar to the search term, as measured by a Levenshtein edit distance.

An edit distance is the number of one-character changes needed to turn one term into another. These changes can include:

• Changing a character (box → fox)
• Removing a character (black → lack)
• Inserting a character (sic → sick)
• Transposing two adjacent characters (act → cat)

To find similar terms, the fuzzy query creates a set of all possible variations, or expansions, of the search term within a specified edit distance. The query then returns exact matches for each expansion.

 GET /_search { "query": { "fuzzy": { "user.id": { "value": "ki" } } } } 

 GET /_search { "query": { "fuzzy": { "user.id": { "value": "ki", "fuzziness": "AUTO", "max_expansions": 50, "prefix_length": 0, "transpositions": true, "rewrite": "constant_score_blended" } } } } 

<field>

(Required, object) Field you wish to search.

value

(Required, string) Term you wish to find in the provided <field>.

fuzziness

(Optional, string) Maximum edit distance allowed for matching. See Fuzziness for valid values and more information.

max_expansions

(Optional, integer) Maximum number of variations created. Defaults to 50.

prefix_length

(Optional, integer) Number of beginning characters left unchanged when creating expansions. Defaults to 0.

transpositions

(Optional, Boolean) Indicates whether edits include transpositions of two adjacent characters (ab → ba). Defaults to true.

rewrite

(Optional, string) Method used to rewrite the query. For valid values and more information, see the rewrite parameter.

Fuzzy queries will not be executed if search.allow_expensive_queries is set to false.