docs: document Use global filters option for ES|QL layers (#6351)#7037
Open
florent-leborgne wants to merge 8 commits into
Open
docs: document Use global filters option for ES|QL layers (#6351)#7037florent-leborgne wants to merge 8 commits into
florent-leborgne wants to merge 8 commits into
Conversation
Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
Contributor
Contributor
Elastic Docs Style Checker (Vale)Summary: 1 suggestion found 💡 Suggestions (1): Optional style improvements. Apply when helpful.
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. |
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>
Co-authored-by: Cursor <cursoragent@cursor.com>
…tings (#6351) Co-authored-by: Cursor <cursoragent@cursor.com>
leemthompo
approved these changes
Jun 23, 2026
leemthompo
left a comment
Member
There was a problem hiding this comment.
Unblocking on the writing side with some tiny suggestions
| serverless: ga | ||
| ``` | ||
|
|
||
| By default, an {{esql}} visualization applies the filters and the KQL or Lucene query set at the dashboard level. To make a layer run its query independently of them, select the {icon}`gear` **Settings** icon on the layer header, then turn off **Use global filters**. |
Member
There was a problem hiding this comment.
Suggested change
| By default, an {{esql}} visualization applies the filters and the KQL or Lucene query set at the dashboard level. To make a layer run its query independently of them, select the {icon}`gear` **Settings** icon on the layer header, then turn off **Use global filters**. | |
| By default, an {{esql}} visualization applies the filters and the KQL or Lucene query set at the dashboard level. To force a layer to run its query without these filters: | |
| 1. Select the {icon}`gear` **Settings** icon on the layer header. | |
| 2. Turn off **Use global filters**. |
minor simplifications
|
|
||
| By default, an {{esql}} visualization applies the filters and the KQL or Lucene query set at the dashboard level. To make a layer run its query independently of them, select the {icon}`gear` **Settings** icon on the layer header, then turn off **Use global filters**. | ||
|
|
||
| This option covers the dashboard's filter pills and the query from the search bar. The dashboard time range is a separate control that always applies, whether or not the option is turned on. |
Member
There was a problem hiding this comment.
is the term pill universally understood? 🤔
| ``` | ||
|
|
||
| Data sampling allows you to improve the visualization loading time. When you can create your visualization, click the **Layer settings** icon {icon}`app_management` and use the slider to adjust the **Sampling** percentage. For example, on large datasets, you can decrease the loading time by using a lower sampling percentage. This increases performance but lowers the accuracy. | ||
| Data sampling allows you to improve the visualization loading time. When you can create your visualization, click the **Settings**/**Layer settings** icon {icon}`gear` and use the slider to adjust the **Sampling** percentage. For example, on large datasets, you can decrease the loading time by using a lower sampling percentage. This increases performance but lowers the accuracy. |
Member
There was a problem hiding this comment.
Suggested change
| Data sampling allows you to improve the visualization loading time. When you can create your visualization, click the **Settings**/**Layer settings** icon {icon}`gear` and use the slider to adjust the **Sampling** percentage. For example, on large datasets, you can decrease the loading time by using a lower sampling percentage. This increases performance but lowers the accuracy. | |
| Data sampling allows you to improve the visualization loading time. When you create your visualization, click the **Settings**/**Layer settings** icon {icon}`gear` and use the slider to adjust the **Sampling** percentage. For example, on large datasets, you can decrease loading time by using a lower sampling percentage. This increases performance but reduces accuracy. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 anIgnore dashboard filterssection 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}gearSettings 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 extraapplies_tobadges), and correct the layer-settings icon fromapp_managementto {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
xpack.lens.layerSettings.ignoreGlobalFilters) and the Settings panel label + {icon}geargear icon (xpack.lens.layerActions.layerSettingsAction,icon: 'gear'). Confirmed the label was Layer settings on the9.4branch and Settings at HEAD, with the icongearin both.LENS_IGNORE_GLOBAL_FILTERS_DEFAULT_VALUE = false, so dashboard filters apply unless the option is turned off.esql.ts; confirmed by tests).Resolves
Closes #6351