[ES|QL] Add Documentation for MMR command by markjhoy · Pull Request #143809 · elastic/elasticsearch

markjhoy · 2026-03-08T21:15:55Z

Adds documentation for the ES|QL MMR command.

github-actions · 2026-03-08T21:20:50Z

🔍 Preview links for changed docs

docs/reference/query-languages/esql/commands/mmr.md

github-actions · 2026-03-08T21:20:51Z

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

Check out the cumulative docs guidelines
Reach out in the #docs Slack channel

carlosdelest

LGTM - please double check the applies_to versions, as they look wrong

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md

leemthompo

Docs wise: one question and one ++ :)

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md

leemthompo · 2026-03-09T10:47:49Z

docs/reference/query-languages/toc.yml

                  - file: esql/commands/keep.md
                  - file: esql/commands/limit.md
                  - file: esql/commands/lookup-join.md
+                  - file: esql/commands/mmr.md


FYI we shouldn't merge this until the command is live on serverless

If you want to merge in hidden mode, you can do the following, and publish at a later date

Suggested change

- file: esql/commands/mmr.md

- hidden: esql/commands/mmr.md

FYI this PR is now merged so the command should be available.

ioanatia

Before we merge this PR, we need to make sure that MMR is available outside of release builds - we need to regen the syntax:

elasticsearch/x-pack/plugin/esql/src/main/antlr/EsqlBaseParser.g4

Line 79 in bacd5a1

| {this.isDevVersion()}? mmrCommand

and also make sure this capability is available in release builds:

elasticsearch/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java

Line 2143 in bacd5a1

MMR_V2(Build.current().isSnapshot()),

also let's make sure we remove this capability before we make this available in release builds:

elasticsearch/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java

Line 2068 in bacd5a1

MMR(Build.current().isSnapshot()),

We only need MMR_V2 when we release.

markjhoy · 2026-03-09T12:59:49Z

Before we merge this PR, we need to make sure that MMR is available outside of release builds - we need to regen the syntax:

elasticsearch/x-pack/plugin/esql/src/main/antlr/EsqlBaseParser.g4

Line 79 in bacd5a1

| {this.isDevVersion()}? mmrCommand

and also make sure this capability is available in release builds:

elasticsearch/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java

Line 2143 in bacd5a1

MMR_V2(Build.current().isSnapshot()),

also let's make sure we remove this capability before we make this available in release builds:

elasticsearch/x-pack/plugin/esql/src/main/java/org/elasticsearch/xpack/esql/action/EsqlCapabilities.java

Line 2068 in bacd5a1

MMR(Build.current().isSnapshot()),

We only need MMR_V2 when we release.

Thanks for calling this out - I'll open up a new PR today for this, then circle back to these docs

markjhoy · 2026-03-09T14:38:06Z

Before we merge this PR, we need to make sure that MMR is available outside of release builds - we need to regen the syntax:
We only need MMR_V2 when we release.

Thanks for calling this out - I'll open up a new PR today for this, then circle back to these docs

PR created to pull this out of dev/snapshot builds: #143867

markjhoy · 2026-03-10T17:15:17Z

PR created to pull this out of dev/snapshot builds: #143867

FYI - this PR is merged now. cc: @ioanatia

elasticsearchmachine · 2026-03-10T20:17:24Z

Pinging @elastic/es-search-relevance (Team:Search Relevance)

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md

markjhoy · 2026-03-30T13:12:47Z

pinging @ioanatia for review

leemthompo

One last version tag and LGTM

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md

* add docs for MMR command * remove 9.4 label for layout * doc updates * update docs; add command comments per Nik * update regen docs * doc cleanups

fixes error introduced in #143809

…145338) fixes error introduced in elastic#143809

* add docs for MMR command * remove 9.4 label for layout * doc updates * update docs; add command comments per Nik * update regen docs * doc cleanups

…145338) fixes error introduced in elastic#143809

add docs for MMR command

59c9f85

elasticsearchmachine added the v9.4.0 label Mar 8, 2026

remove 9.4 label for layout

6214ed6

markjhoy requested review from a team and ioanatia March 8, 2026 21:28

markjhoy added >docs General docs changes >non-issue labels Mar 8, 2026

markjhoy marked this pull request as ready for review March 8, 2026 21:28

markjhoy requested a review from a team as a code owner March 8, 2026 21:28

elasticsearchmachine added the needs:triage Requires assignment of a team area label label Mar 8, 2026

markjhoy added the Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch label Mar 8, 2026

elasticsearchmachine removed the Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch label Mar 8, 2026

carlosdelest approved these changes Mar 9, 2026

View reviewed changes

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md Outdated Show resolved Hide resolved

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md Show resolved Hide resolved

leemthompo reviewed Mar 9, 2026

View reviewed changes

ioanatia requested changes Mar 9, 2026

View reviewed changes

markjhoy added 2 commits March 10, 2026 13:06

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

89bdb36

doc updates

7a78a5b

markjhoy requested review from ioanatia and leemthompo March 10, 2026 17:14

mayya-sharipova added :Search Relevance/ES|QL Search functionality in ES|QL and removed needs:triage Requires assignment of a team area label labels Mar 10, 2026

elasticsearchmachine added the Team:Search Relevance Meta label for the Search Relevance team in Elasticsearch label Mar 10, 2026

ioanatia reviewed Mar 11, 2026

View reviewed changes

markjhoy added 2 commits March 17, 2026 08:44

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

5a73a5a

update docs; add command comments per Nik

27bc86c

markjhoy requested a review from ioanatia March 24, 2026 12:43

markjhoy added 4 commits March 24, 2026 09:53

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

cbf4213

update regen docs

3b7e926

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

1ec6b92

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

019eaa9

ioanatia approved these changes Mar 30, 2026

View reviewed changes

leemthompo approved these changes Mar 30, 2026

View reviewed changes

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md Outdated Show resolved Hide resolved

leemthompo reviewed Mar 30, 2026

View reviewed changes

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md Outdated Show resolved Hide resolved

leemthompo reviewed Mar 30, 2026

View reviewed changes

docs/reference/query-languages/esql/_snippets/commands/layout/mmr.md Outdated Show resolved Hide resolved

markjhoy added 2 commits March 30, 2026 12:11

Merge branch 'main' into markjhoy/add_mmr_esql_documentation

d707f5f

doc cleanups

512c071

markjhoy enabled auto-merge (squash) March 30, 2026 17:10

markjhoy merged commit e6c9c34 into elastic:main Mar 30, 2026
36 checks passed

leemthompo added a commit that referenced this pull request Mar 31, 2026

[DOCS] Fix conflict markers in ESQL processing command list

c06bfa6

fixes error introduced in #143809

leemthompo mentioned this pull request Mar 31, 2026

[DOCS] Fix conflict markers in ESQL processing command list #145338

Merged

leemthompo added a commit that referenced this pull request Mar 31, 2026

[DOCS] Fix conflict markers in ESQL processing command list (#145338)

e7f7975

fixes error introduced in #143809

seanzatzdev pushed a commit to seanzatzdev/elasticsearch that referenced this pull request Mar 31, 2026

[DOCS] Fix conflict markers in ESQL processing command list (elastic#…

6e03010

…145338) fixes error introduced in elastic#143809

seanzatzdev pushed a commit to seanzatzdev/elasticsearch that referenced this pull request Mar 31, 2026

[DOCS] Fix conflict markers in ESQL processing command list (elastic#…

83757cd

…145338) fixes error introduced in elastic#143809

ncordon pushed a commit to ncordon/elasticsearch that referenced this pull request Apr 1, 2026

[DOCS] Fix conflict markers in ESQL processing command list (elastic#…

5a9b874

…145338) fixes error introduced in elastic#143809

mromaios pushed a commit to mromaios/elasticsearch that referenced this pull request Apr 9, 2026

[DOCS] Fix conflict markers in ESQL processing command list (elastic#…

e164c08

…145338) fixes error introduced in elastic#143809

Conversation

markjhoy commented Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Mar 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Preview links for changed docs

Uh oh!

github-actions bot commented Mar 8, 2026

ℹ️ Important: Docs version tagging

When to use applies_to tags:

What NOT to do:

🤔 Need help?

Uh oh!

carlosdelest left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

leemthompo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

leemthompo Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

markjhoy Mar 10, 2026

Choose a reason for hiding this comment

Uh oh!

ioanatia left a comment

Choose a reason for hiding this comment

Uh oh!

markjhoy commented Mar 9, 2026

Uh oh!

markjhoy commented Mar 9, 2026

Uh oh!

markjhoy commented Mar 10, 2026

Uh oh!

elasticsearchmachine commented Mar 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

markjhoy commented Mar 30, 2026

Uh oh!

leemthompo left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

markjhoy commented Mar 8, 2026 •

edited

Loading

github-actions bot commented Mar 8, 2026 •

edited

Loading