Skip to content

docs: document Use global filters option for ES|QL layers (#6351)#7037

Merged
florent-leborgne merged 10 commits into
mainfrom
docs-issue-6351-esql-global-filters
Jun 25, 2026
Merged

docs: document Use global filters option for ES|QL layers (#6351)#7037
florent-leborgne merged 10 commits into
mainfrom
docs-issue-6351-esql-global-filters

Conversation

@florent-leborgne

@florent-leborgne florent-leborgne commented Jun 19, 2026

Copy link
Copy Markdown
Member

Summary

This PR addresses #6351 by documenting the new per-layer Use global filters option for ES|QL visualizations, added in 9.5.0 and serverless (elastic/kibana#264613). The same Kibana PR renamed the Lens layer settings action and panel title from Layer settings to Settings (9.5+), so this PR also brings the existing references up to date.

  • explore-analyze/visualize/esorql.md: adds an Ignore dashboard filters section explaining that, by default, an ES|QL visualization applies the dashboard filters and the KQL or Lucene query, and that turning off Use global filters in the {icon}gear Settings panel makes a layer run its query independently of them. Clarifies that this covers the dashboard's filter pills and search bar query, while the time range always applies.
  • explore-analyze/visualize/lens.md, explore-analyze/visualize/charts/pie-charts.md, explore-analyze/visualize/charts/waffle-charts.md: update the Lens layer settings references to the slash form Settings/Layer settings (so both labels are covered without extra applies_to badges), and correct the layer-settings icon from app_management to {icon}gear. The 9.0-9.2 kebab-menu steps and the separate Maps "Layer settings" label are left unchanged.

The ES|QL setting is layer-specific, so it's documented on the dedicated ES|QL visualizations page (narrower scope) rather than the broader Lens page, which already links to it.

Verified against source at HEAD

  • Toggle label Use global filters (xpack.lens.layerSettings.ignoreGlobalFilters) and the Settings panel label + {icon}gear gear icon (xpack.lens.layerActions.layerSettingsAction, icon: 'gear'). Confirmed the label was Layer settings on the 9.4 branch and Settings at HEAD, with the icon gear in both.
  • Default is on: LENS_IGNORE_GLOBAL_FILTERS_DEFAULT_VALUE = false, so dashboard filters apply unless the option is turned off.
  • Turning it off makes the layer ignore the dashboard filter pills and the KQL/Lucene query, but the time range still applies (the time filter is added unconditionally in esql.ts; confirmed by tests).

Resolves

Closes #6351


AI-generated draft — created with Claude Opus 4.8.
Review all generated content for factual accuracy before merging.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs Style Checker (Vale)

Summary: 1 suggestion found

💡 Suggestions (1): Optional style improvements. Apply when helpful.
File Line Rule Message
explore-analyze/visualize/esorql.md 143 Elastic.Wordiness Consider using 'whether' instead of 'whether or not'.

The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

florent-leborgne and others added 7 commits June 19, 2026 21:22
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
…tings (#6351)

Co-authored-by: Cursor <cursoragent@cursor.com>
)

Co-authored-by: Cursor <cursoragent@cursor.com>
@florent-leborgne florent-leborgne marked this pull request as ready for review June 19, 2026 20:01
@florent-leborgne florent-leborgne requested review from a team as code owners June 19, 2026 20:01

@leemthompo leemthompo left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Unblocking on the writing side with some tiny suggestions

Comment thread explore-analyze/visualize/esorql.md Outdated
Comment thread explore-analyze/visualize/esorql.md
Comment thread explore-analyze/visualize/lens.md Outdated
@florent-leborgne florent-leborgne enabled auto-merge (squash) June 25, 2026 12:21
@florent-leborgne florent-leborgne merged commit b6c3224 into main Jun 25, 2026
8 checks passed
@florent-leborgne florent-leborgne deleted the docs-issue-6351-esql-global-filters branch June 25, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Use global filters toggle for ES|QL Lens layers

2 participants