elasticsearch/docs/reference/query-languages/esql/_snippets/functions/functionNamedParams/multi_match.md

% This is generated by ESQL's AbstractFunctionTestCase. Do not edit it. See ../README.md for how to regenerate it.

Supported function named parameters

fuzziness : (keyword) Maximum edit distance allowed for matching.

auto_generate_synonyms_phrase_query : (boolean) If true, match phrase queries are automatically created for multi-term synonyms. Defaults to true.

minimum_should_match : (integer) Minimum number of clauses that must match for a document to be returned.

fuzzy_transpositions : (boolean) If true, edits for fuzzy matching include transpositions of two adjacent characters (ab → ba). Defaults to true.

tie_breaker : (float) Controls how score is blended together between field groups. Defaults to 0 (best score from each group).

type : (object) Controls the way multi_match is executed internally. Can be one of best_fields, most_fields, cross_fields, phrase, phrase_prefix or bool_prefix. Defaults to 'best_fields'. See <>.

lenient : (boolean) If false, format-based errors, such as providing a text query value for a numeric field, are returned. Defaults to true.

operator : (keyword) Boolean logic used to interpret text in the query value. Defaults to OR.

max_expansions : (integer) Maximum number of terms to which the query will expand. Defaults to 50.

analyzer : (keyword) Analyzer used to convert the text in the query value into token. Defaults to the index-time analyzer mapped for the field. If no analyzer is mapped, the index’s default analyzer is used.

boost : (float) Floating point number used to decrease or increase the relevance scores of the query.

fuzzy_rewrite : (keyword) Method used to rewrite the query. See the rewrite parameter for valid values and more information. If the fuzziness parameter is not 0, the match query uses a fuzzy_rewrite method of top_terms_blendedfreqs${max_expansions} by default.

prefix_length : (integer) Number of beginning characters left unchanged for fuzzy matching. Defaults to 0.