From 8ca7325f6537898fe6989edf2bcd9860221068b8 Mon Sep 17 00:00:00 2001 From: Alan Woodward Date: Thu, 4 Apr 2019 09:07:42 +0100 Subject: [PATCH] Document restrictions on fuzzy matching when using synonyms (#40783) Relates to #25518 --- docs/reference/query-dsl/match-query.asciidoc | 4 ++++ 1 file changed, 4 insertions(+) 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):