diff --git a/docs/reference/mapping/params/normalizer.asciidoc b/docs/reference/mapping/params/normalizer.asciidoc index c69e816380d..723f79c5dc4 100644 --- a/docs/reference/mapping/params/normalizer.asciidoc +++ b/docs/reference/mapping/params/normalizer.asciidoc @@ -7,7 +7,8 @@ produces a single token. The `normalizer` is applied prior to indexing the keyword, as well as at search-time when the `keyword` field is searched via a query parser such as -the <> query. +the <> query or via a term level query +such as the <> query. [source,js] -------------------------------- @@ -53,6 +54,15 @@ PUT index/_doc/3 POST index/_refresh +GET index/_search +{ + "query": { + "term": { + "foo": "BAR" + } + } +} + GET index/_search { "query": { @@ -64,7 +74,7 @@ GET index/_search -------------------------------- // CONSOLE -The above query matches documents 1 and 2 since `BÀR` is converted to `bar` at +The above queries match documents 1 and 2 since `BÀR` is converted to `bar` at both index and query time. [source,js] diff --git a/docs/reference/query-dsl/term-level-queries.asciidoc b/docs/reference/query-dsl/term-level-queries.asciidoc index 883fd4c36b5..f4e185ba959 100644 --- a/docs/reference/query-dsl/term-level-queries.asciidoc +++ b/docs/reference/query-dsl/term-level-queries.asciidoc @@ -3,7 +3,8 @@ While the <> will analyze the query string before executing, the _term-level queries_ operate on the exact terms -that are stored in the inverted index. +that are stored in the inverted index, and will normalize terms before executing +only for <> fields with <> property. These queries are usually used for structured data like numbers, dates, and enums, rather than full text fields. Alternatively, they allow you to craft