Skip to content

Update saved queries documentation #3576

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 21, 2025
Merged

Update saved queries documentation #3576

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bbc6a63
Update saved queries documentation
florent-leborgne Oct 21, 2025
f43846f
Merge branch 'main' into florent-leborgne-patch-2
florent-leborgne Oct 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 10 additions & 7 deletions explore-analyze/query-filter/tools/saved-queries.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,20 +16,23 @@ For example, suppose you’re in **Discover**, and you’ve put time into buildi

Saved queries are different than [saved Discover sessions](/explore-analyze/discover/save-open-search.md), which include the **Discover** configuration—selected columns in the document table, sort order, and {{data-source}}—in addition to the query. Discover sessions are primarily used for adding search results to a dashboard.

## Saved query access [_saved_query_access]
:::{note}
Saved queries aren't available for {{esql}} queries. When using {{esql}}, the editor automatically keeps an [history of your most recent queries](/explore-analyze/query-filter/languages/esql-kibana.md#esql-kibana-query-history), and you can also [mark some as favorite](/explore-analyze/query-filter/languages/esql-kibana.md#esql-kibana-starred-queries) to find them faster later.
:::

If you have insufficient privileges to manage saved queries, you will be unable to load or save queries from the saved query management popover. For more information, see [Granting access to Kibana](elasticsearch://reference/elasticsearch/roles.md)
## Saved queries requirements [_saved_query_access]

You must have **Saved Query Management** privileges in {{kib}} to use saved queries.


## Save a query [_save_a_query]

1. Once you’ve built a query worth saving, click the save query icon ![save query icon](/explore-analyze/images/kibana-saved-query-icon.png "").
2. In the menu, select the item to save the query.
1. Once you’ve built a query worth saving, open the {icon}`filter` **Query menu**.
2. In the menu, select **Save query**.
3. Enter a unique name.
4. Choose whether to include or exclude filters and a time range. By default, filters are automatically included, but the time filter is not.
5. Save the query.
6. To load a saved query, select it in the **Saved query** menu.

The query text, filters, and time range are updated and your data refreshed. If you’re loading a saved query that did not include the filters or time range, those components remain as-is.
The query is saved. You can load it at any time by opening the **Query menu** again and selecting **Load query**.

7. To add filters and clear saved queries, use the **Saved query** menu.
When you load a saved query, the query text, filters, and time range are updated and your data refreshed. If you’re loading a saved query that did not include the filters or time range, those components remain as-is.