Skip to content

Commit 2fcf696

Browse files
Update saved queries documentation (#3576)
Updated instructions for saved queries, added a mention of ES|QL, and clarified access requirements. Fixes: #3575
1 parent 44aba64 commit 2fcf696

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

explore-analyze/query-filter/tools/saved-queries.md

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,20 +16,23 @@ For example, suppose you’re in **Discover**, and you’ve put time into buildi
1616

1717
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.
1818

19-
## Saved query access [_saved_query_access]
19+
:::{note}
20+
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.
21+
:::
2022

21-
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)
23+
## Saved queries requirements [_saved_query_access]
24+
25+
You must have **Saved Query Management** privileges in {{kib}} to use saved queries.
2226

2327

2428
## Save a query [_save_a_query]
2529

26-
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 "").
27-
2. In the menu, select the item to save the query.
30+
1. Once you’ve built a query worth saving, open the {icon}`filter` **Query menu**.
31+
2. In the menu, select **Save query**.
2832
3. Enter a unique name.
2933
4. Choose whether to include or exclude filters and a time range. By default, filters are automatically included, but the time filter is not.
3034
5. Save the query.
31-
6. To load a saved query, select it in the **Saved query** menu.
3235

33-
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.
36+
The query is saved. You can load it at any time by opening the **Query menu** again and selecting **Load query**.
3437

35-
7. To add filters and clear saved queries, use the **Saved query** menu.
38+
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.

0 commit comments

Comments
 (0)