Skip to content

[ES|QL controls] Add MV_INTERSECTS to multi-select control callout#264353

Merged
florent-leborgne merged 2 commits intomainfrom
esql-controls-mv-intersects
Apr 20, 2026
Merged

[ES|QL controls] Add MV_INTERSECTS to multi-select control callout#264353
florent-leborgne merged 2 commits intomainfrom
esql-controls-mv-intersects

Conversation

@florent-leborgne
Copy link
Copy Markdown
Member

@florent-leborgne florent-leborgne commented Apr 20, 2026

Summary

The info callout shown when switching an ES|QL control to multi-select mode previously only mentioned MV_CONTAINS. This PR updates it to also mention MV_INTERSECTS, which is equally valid for filtering multi-value fields.

  • Updates the callout message to: "You must use MV_CONTAINS or MV_INTERSECTS in your ES|QL query for multi-select controls to work."
  • Adds a queryESQLMvIntersects entry to the doc links service (kbn-doc-links) pointing to the MV_INTERSECTS function reference
  • MV_INTERSECTS in the callout links to that doc page via the doc links service, consistent with how MV_CONTAINS links to the multi-value controls guide

Test plan

  • Open an ES|QL control flyout, switch Selections to Multi, and verify the callout now reads "You must use MV_CONTAINS or MV_INTERSECTS in your ES|QL query for multi-select controls to work."
  • Confirm both function names are clickable links pointing to the correct docs pages.

Made with Cursor

@florent-leborgne florent-leborgne requested review from a team as code owners April 20, 2026 09:52
@florent-leborgne florent-leborgne added release_note:skip Skip the PR/issue when compiling release notes backport:version Backport to applied version labels v9.4.0 v9.3.4 Team:Docs Team:ESQL ES|QL related features in Kibana t// labels Apr 20, 2026
@elasticmachine
Copy link
Copy Markdown
Contributor

Pinging @elastic/experience-docs (Team:Docs)

@elasticmachine
Copy link
Copy Markdown
Contributor

Pinging @elastic/kibana-esql (Team:ESQL)

Copy link
Copy Markdown
Contributor

@stratoula stratoula left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Florent ❤️

@elasticmachine
Copy link
Copy Markdown
Contributor

⏳ Build in-progress, with failures

Failed CI Steps

Test Failures

  • [job] [logs] affected Scout: [ platform / alerting ] plugin / local-serverless-observability_complete - API key invalidation on rule operations - update_api_key rotates both apiKey and uiamApiKey

History

The info callout shown when switching to multi-select mode now mentions
both MV_CONTAINS and MV_INTERSECTS as valid functions to use. Adds a
dedicated doc link for MV_INTERSECTS using the doc links service.

Made-with: Cursor
The i18n check requires translations to use the same value keys as the
source message. Since the callout now takes two values (mvContainsLink
and mvIntersectsLink), the existing single-value translations are
incompatible. Removing them so they fall back to English until the
localization team re-translates.

Made-with: Cursor
@florent-leborgne florent-leborgne force-pushed the esql-controls-mv-intersects branch from a1e8c98 to 3405fe6 Compare April 20, 2026 15:45
@florent-leborgne florent-leborgne merged commit 7b8115e into main Apr 20, 2026
19 checks passed
@florent-leborgne florent-leborgne deleted the esql-controls-mv-intersects branch April 20, 2026 17:42
@kibanamachine
Copy link
Copy Markdown
Contributor

Starting backport for target branches: 9.3, 9.4

https://github.com/elastic/kibana/actions/runs/24681327246

@kibanamachine
Copy link
Copy Markdown
Contributor

💔 Some backports could not be created

Status Branch Result
9.3 Backport failed because of merge conflicts
9.4

Note: Successful backport PRs will be merged automatically after passing CI.

Manual backport

To create the backport manually run:

node scripts/backport --pr 264353

Questions ?

Please refer to the Backport tool documentation

kibanamachine added a commit that referenced this pull request Apr 20, 2026
…out (#264353) (#264496)

# Backport

This will backport the following commits from `main` to `9.4`:
- [[ES|QL controls] Add MV_INTERSECTS to multi-select control callout
(#264353)](#264353)

<!--- Backport version: 9.6.6 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sorenlouv/backport)

<!--BACKPORT [{"author":{"name":"Florent
LB","email":"florent.leborgne@elastic.co"},"sourceCommit":{"committedDate":"2026-04-20T17:42:00Z","message":"[ES|QL
controls] Add MV_INTERSECTS to multi-select control callout
(#264353)\n\n## Summary\n\nThe info callout shown when switching an
ES|QL control to multi-select\nmode previously only mentioned
`MV_CONTAINS`. This PR updates it to also\nmention `MV_INTERSECTS`,
which is equally valid for filtering\nmulti-value fields.\n\n- Updates
the callout message to: _\"You must use MV_CONTAINS or\nMV_INTERSECTS in
your ES|QL query for multi-select controls to work.\"_\n- Adds a
`queryESQLMvIntersects` entry to the doc links
service\n(`kbn-doc-links`) pointing to the [MV_INTERSECTS
function\nreference](https://www.elastic.co/docs/reference/query-languages/esql/functions-operators/mv-functions/mv_intersects)\n-
`MV_INTERSECTS` in the callout links to that doc page via the doc\nlinks
service, consistent with how `MV_CONTAINS` links to the\nmulti-value
controls guide\n\n## Test plan\n\n- [ ] Open an ES|QL control flyout,
switch **Selections** to **Multi**,\nand verify the callout now reads
\"You must use **MV_CONTAINS** or\n**MV_INTERSECTS** in your ES|QL query
for multi-select controls to\nwork.\"\n- [ ] Confirm both function names
are clickable links pointing to the\ncorrect docs pages.\n\nMade with
[Cursor](https://cursor.com)","sha":"7b8115ef5e6f126b6d7f72ad5c1530760234bef0","branchLabelMapping":{"^v9.5.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","Team:ESQL","backport:version","v9.4.0","v9.5.0","v9.3.4"],"title":"[ES|QL
controls] Add MV_INTERSECTS to multi-select control
callout","number":264353,"url":"https://github.com/elastic/kibana/pull/264353","mergeCommit":{"message":"[ES|QL
controls] Add MV_INTERSECTS to multi-select control callout
(#264353)\n\n## Summary\n\nThe info callout shown when switching an
ES|QL control to multi-select\nmode previously only mentioned
`MV_CONTAINS`. This PR updates it to also\nmention `MV_INTERSECTS`,
which is equally valid for filtering\nmulti-value fields.\n\n- Updates
the callout message to: _\"You must use MV_CONTAINS or\nMV_INTERSECTS in
your ES|QL query for multi-select controls to work.\"_\n- Adds a
`queryESQLMvIntersects` entry to the doc links
service\n(`kbn-doc-links`) pointing to the [MV_INTERSECTS
function\nreference](https://www.elastic.co/docs/reference/query-languages/esql/functions-operators/mv-functions/mv_intersects)\n-
`MV_INTERSECTS` in the callout links to that doc page via the doc\nlinks
service, consistent with how `MV_CONTAINS` links to the\nmulti-value
controls guide\n\n## Test plan\n\n- [ ] Open an ES|QL control flyout,
switch **Selections** to **Multi**,\nand verify the callout now reads
\"You must use **MV_CONTAINS** or\n**MV_INTERSECTS** in your ES|QL query
for multi-select controls to\nwork.\"\n- [ ] Confirm both function names
are clickable links pointing to the\ncorrect docs pages.\n\nMade with
[Cursor](https://cursor.com)","sha":"7b8115ef5e6f126b6d7f72ad5c1530760234bef0"}},"sourceBranch":"main","suggestedTargetBranches":["9.4","9.3"],"targetPullRequestStates":[{"branch":"9.4","label":"v9.4.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"main","label":"v9.5.0","branchLabelMappingKey":"^v9.5.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/264353","number":264353,"mergeCommit":{"message":"[ES|QL
controls] Add MV_INTERSECTS to multi-select control callout
(#264353)\n\n## Summary\n\nThe info callout shown when switching an
ES|QL control to multi-select\nmode previously only mentioned
`MV_CONTAINS`. This PR updates it to also\nmention `MV_INTERSECTS`,
which is equally valid for filtering\nmulti-value fields.\n\n- Updates
the callout message to: _\"You must use MV_CONTAINS or\nMV_INTERSECTS in
your ES|QL query for multi-select controls to work.\"_\n- Adds a
`queryESQLMvIntersects` entry to the doc links
service\n(`kbn-doc-links`) pointing to the [MV_INTERSECTS
function\nreference](https://www.elastic.co/docs/reference/query-languages/esql/functions-operators/mv-functions/mv_intersects)\n-
`MV_INTERSECTS` in the callout links to that doc page via the doc\nlinks
service, consistent with how `MV_CONTAINS` links to the\nmulti-value
controls guide\n\n## Test plan\n\n- [ ] Open an ES|QL control flyout,
switch **Selections** to **Multi**,\nand verify the callout now reads
\"You must use **MV_CONTAINS** or\n**MV_INTERSECTS** in your ES|QL query
for multi-select controls to\nwork.\"\n- [ ] Confirm both function names
are clickable links pointing to the\ncorrect docs pages.\n\nMade with
[Cursor](https://cursor.com)","sha":"7b8115ef5e6f126b6d7f72ad5c1530760234bef0"}},{"branch":"9.3","label":"v9.3.4","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: Florent LB <florent.leborgne@elastic.co>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport:version Backport to applied version labels release_note:skip Skip the PR/issue when compiling release notes Team:Docs Team:ESQL ES|QL related features in Kibana t// v9.3.4 v9.4.0 v9.5.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants