diff --git a/docs/reference/query-dsl/match-query.asciidoc b/docs/reference/query-dsl/match-query.asciidoc index b4e90e77650..890026cba4e 100644 --- a/docs/reference/query-dsl/match-query.asciidoc +++ b/docs/reference/query-dsl/match-query.asciidoc @@ -56,6 +56,10 @@ rewritten. Fuzzy transpositions (`ab` -> `ba`) are allowed by default but can be disabled by setting `fuzzy_transpositions` to `false`. +Note that fuzzy matching is not applied to terms with synonyms, as under the hood +these terms are expanded to a special synonym query that blends term frequencies, +which does not support fuzzy expansion. + Here is an example when providing additional parameters (note the slight change in structure, `message` is the field name):