elastic · kderusso · Jun 9, 2025 · Jun 4, 2025 · Jun 4, 2025 · Jun 5, 2025
diff --git a/docs/changelog/128925.yaml b/docs/changelog/128925.yaml
@@ -0,0 +1,5 @@
+pr: 128925
+summary: Take `match_phrase` out of snapshot and make tech preview
+area: ES|QL
+type: enhancement
+issues: []
diff --git a/docs/reference/query-languages/esql/_snippets/lists/search-functions.md b/docs/reference/query-languages/esql/_snippets/lists/search-functions.md
@@ -1,6 +1,6 @@
 * [preview] [`KQL`](../../functions-operators/search-functions.md#esql-kql)
 * [preview] [`MATCH`](../../functions-operators/search-functions.md#esql-match)
-  % * [preview] [
+* [preview] [
   `MATCH_PHRASE`](../../functions-operators/search-functions.md#esql-match-phrase)
 * [preview] [`QSTR`](../../functions-operators/search-functions.md#esql-qstr)
   % * [preview] [

diff --git a/docs/reference/query-languages/esql/functions-operators/search-functions.md b/docs/reference/query-languages/esql/functions-operators/search-functions.md
@@ -36,9 +36,8 @@ for information on the limitations of full text search.
 :::{include} ../_snippets/functions/layout/match.md
 :::
 
-% MATCH_PHRASE is currently hidden
-% :::{include} ../_snippets/functions/layout/match_phrase.md
-% :::
+:::{include} ../_snippets/functions/layout/match_phrase.md
+:::
 
 :::{include} ../_snippets/functions/layout/qstr.md
 :::

diff --git a/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java b/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java
@@ -1169,7 +1169,7 @@ public enum Cap {
         /**
          * MATCH PHRASE function
          */
-        MATCH_PHRASE_FUNCTION(Build.current().isSnapshot());
+        MATCH_PHRASE_FUNCTION;
 
         private final boolean enabled;
 

diff --git a/...ain/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java b/...ain/java/org/elasticsearch/xpack/esql/expression/function/fulltext/FullTextWritables.java
@@ -23,15 +23,12 @@ public static List<NamedWriteableRegistry.Entry> getNamedWriteables() {
         entries.add(Match.ENTRY);
         entries.add(MultiMatch.ENTRY);
         entries.add(Kql.ENTRY);
+        entries.add(MatchPhrase.ENTRY);
 
         if (EsqlCapabilities.Cap.TERM_FUNCTION.isEnabled()) {
             entries.add(Term.ENTRY);
         }
 
-        if (EsqlCapabilities.Cap.MATCH_PHRASE_FUNCTION.isEnabled()) {
-            entries.add(MatchPhrase.ENTRY);
-        }
-
         return Collections.unmodifiableList(entries);
     }
 }
diff --git a/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml b/x-pack/plugin/src/yamlRestTest/resources/rest-api-spec/test/esql/60_usage.yml
@@ -130,7 +130,7 @@ setup:
   - match: {esql.functions.coalesce: $functions_coalesce}
   - gt: {esql.functions.categorize: $functions_categorize}
   # Testing for the entire function set isn't feasible, so we just check that we return the correct count as an approximation.
-  - length: {esql.functions: 156} # check the "sister" test below for a likely update to the same esql.functions length check
+  - length: {esql.functions: 157} # check the "sister" test below for a likely update to the same esql.functions length check
 
 ---
 "Basic ESQL usage output (telemetry) non-snapshot version":
@@ -228,7 +228,7 @@ setup:
   - gt: {esql.functions.to_long: $functions_to_long}
   - match: {esql.functions.coalesce: $functions_coalesce}
   - gt: {esql.functions.categorize: $functions_categorize}
-  - length: {esql.functions: 144} # check the "sister" test above for a likely update to the same esql.functions length check
+  - length: {esql.functions: 145} # check the "sister" test above for a likely update to the same esql.functions length check
 
 ---
 took: