From d73261d73f3ccbc9b4de420416ff09c965c32091 Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Wed, 6 Aug 2025 19:15:10 +0200 Subject: [PATCH 1/4] Docs for global filters --- explore-analyze/_snippets/global-filters.md | 24 +++++++++++++++++++ explore-analyze/dashboards/using.md | 5 ++++ .../discover/discover-get-started.md | 5 ++++ 3 files changed, 34 insertions(+) create mode 100644 explore-analyze/_snippets/global-filters.md diff --git a/explore-analyze/_snippets/global-filters.md b/explore-analyze/_snippets/global-filters.md new file mode 100644 index 0000000000..26d21dc046 --- /dev/null +++ b/explore-analyze/_snippets/global-filters.md @@ -0,0 +1,24 @@ +You can interact with filter pills to edit them, temporarily alter their behavior without having to delete them, or make them available in other contexts. The following options are available when selecting a filter pill: + +**Pin across all apps** and **Unpin** +: Adds this filter to other dashboards available to you and to Discover. The filter is removed if you: + * Unpin it. In this case, the filter only remains on the currently open app, unpinned. + * Remove it from any place while it's still pinned. + + :::{tip} + When a pinned filter can't be applied, for example if a field specified in the filter doesn't exist in the current data view, the filter is ignored and shows in a different color. + ::: + +**Edit filter** +: Lets you edit and update the filter. + +**Exclude results** and **Include results** +: Reverses the filter behavior. + +**Temporarily disable** and **Re-enable** +: Lets you temporarily disable a filter instead of requiring you to delete it. This is particularly useful for testing different filter combinations. + +**Delete** +: Deletes the filter. + +You can perform most of these actions at once for all filters in your current view using the **Filter** icon {icon}`filter`. From the menu that opens, select **Apply to all**, then choose the action you'd like to perform. \ No newline at end of file diff --git a/explore-analyze/dashboards/using.md b/explore-analyze/dashboards/using.md index ab04d46039..5d91e79f39 100644 --- a/explore-analyze/dashboards/using.md +++ b/explore-analyze/dashboards/using.md @@ -52,6 +52,11 @@ As an alternative to the main query bar, you can filter dashboard data by defini :alt: Filter editor with 2 conditions ::: +#### Filter pill actions + +:::{include} ../_snippets/global-filters.md +::: + ### Filter dashboards using the KQL query bar [_filter_dashboards_using_the_kql_query_bar] diff --git a/explore-analyze/discover/discover-get-started.md b/explore-analyze/discover/discover-get-started.md index 0bee2283b5..f2bd31251b 100644 --- a/explore-analyze/discover/discover-get-started.md +++ b/explore-analyze/discover/discover-get-started.md @@ -253,6 +253,11 @@ For example, exclude results from the ecommerce sample data view where day of we 4. Continue your exploration by adding more filters. 5. To remove a filter, click the close icon (x) next to its name in the filter bar. +#### Filter pill actions + +:::{include} ../_snippets/global-filters.md +::: + ### Search and filter using ES|QL [_search_and_filter_using_esql] From 33a2b0d9ef9154ec6a049a01611650be4493f2db Mon Sep 17 00:00:00 2001 From: florent-leborgne Date: Wed, 6 Aug 2025 19:43:03 +0200 Subject: [PATCH 2/4] Update explore-analyze/_snippets/global-filters.md --- explore-analyze/_snippets/global-filters.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/explore-analyze/_snippets/global-filters.md b/explore-analyze/_snippets/global-filters.md index 26d21dc046..0349566351 100644 --- a/explore-analyze/_snippets/global-filters.md +++ b/explore-analyze/_snippets/global-filters.md @@ -1,7 +1,7 @@ You can interact with filter pills to edit them, temporarily alter their behavior without having to delete them, or make them available in other contexts. The following options are available when selecting a filter pill: **Pin across all apps** and **Unpin** -: Adds this filter to other dashboards available to you and to Discover. The filter is removed if you: +: Adds this filter to available dashboards and to apps such as **Discover**, **Lens**, **Maps**, and **Visualize**. The filter is removed if you: * Unpin it. In this case, the filter only remains on the currently open app, unpinned. * Remove it from any place while it's still pinned. From 792c8fc05b84621ebb06fdeca6486597020e7f35 Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Wed, 6 Aug 2025 19:49:56 +0200 Subject: [PATCH 3/4] add content to other apps --- explore-analyze/visualize/lens.md | 5 +++++ explore-analyze/visualize/maps/maps-getting-started.md | 3 +++ 2 files changed, 8 insertions(+) diff --git a/explore-analyze/visualize/lens.md b/explore-analyze/visualize/lens.md index 06837758f5..4830b98f87 100644 --- a/explore-analyze/visualize/lens.md +++ b/explore-analyze/visualize/lens.md @@ -455,6 +455,11 @@ In the legend, click the field, then choose one of the following options: * **Filter for value** — Applies a filter that displays only the field data in the visualization. * **Filter out value** — Applies a filter that removes the field data from the visualization. +#### Filter pill actions + +:::{include} ../_snippets/global-filters.md +::: + ## Customize the visualization display [configure-the-visualization-components] diff --git a/explore-analyze/visualize/maps/maps-getting-started.md b/explore-analyze/visualize/maps/maps-getting-started.md index 39fa80e973..75994ba074 100644 --- a/explore-analyze/visualize/maps/maps-getting-started.md +++ b/explore-analyze/visualize/maps/maps-getting-started.md @@ -187,7 +187,10 @@ View your geospatial data alongside a heat map and pie chart, and then filter th :screenshot: ::: +### Filter pill actions +:::{include} ../../_snippets/global-filters.md +::: ## What’s next? [_whats_next_6] From 177aaba5c6515a5ecfd9d0bf61b6ec16ba91add1 Mon Sep 17 00:00:00 2001 From: Florent Le Borgne Date: Wed, 6 Aug 2025 19:56:02 +0200 Subject: [PATCH 4/4] specify that pinned filters aren't saved along with the object --- explore-analyze/_snippets/global-filters.md | 1 + 1 file changed, 1 insertion(+) diff --git a/explore-analyze/_snippets/global-filters.md b/explore-analyze/_snippets/global-filters.md index 26d21dc046..67efbaadf4 100644 --- a/explore-analyze/_snippets/global-filters.md +++ b/explore-analyze/_snippets/global-filters.md @@ -4,6 +4,7 @@ You can interact with filter pills to edit them, temporarily alter their behavio : Adds this filter to other dashboards available to you and to Discover. The filter is removed if you: * Unpin it. In this case, the filter only remains on the currently open app, unpinned. * Remove it from any place while it's still pinned. + * Refresh your session, for example by opening a dashboard in a new tab. Pinned filters are not saved along with the dashboard, visualization, or Discover session that you added them to. :::{tip} When a pinned filter can't be applied, for example if a field specified in the filter doesn't exist in the current data view, the filter is ignored and shows in a different color.