elastic · florent-leborgne · Nov 27, 2025 · Nov 25, 2025 · Nov 25, 2025 · Nov 25, 2025
diff --git a/.gitignore b/.gitignore
@@ -9,7 +9,7 @@
 # Add LLM/AI related files
 AGENTS.md
 .github/copilot-instructions.md
-.github/instructions/**.instructions.md
+.github/instructions
 CLAUDE.md
 GEMINI.md
 .cursor

@@ -6,14 +6,22 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Use Discover to search and filter documents, analyze field structures, visualize patterns, and save findings to reuse later or share with dashboards.
 ---
 
 # Discover [discover]
 
-You have questions about your data. What pages on your website contain a specific word or phrase? What events were logged most recently? What processes take longer than 500 milliseconds to respond?
+**Discover** is the primary tool for exploring your {{product.elasticsearch}} data in {{product.kibana}}. Search and filter documents, analyze field structures, visualize patterns, and save findings to reuse later or share with dashboards. Whether investigating issues, analyzing trends, or validating data quality, **Discover** offers a flexible interface for understanding your data.
 
-$$$save-your-search$$$
-With **Discover**, you can quickly search and filter your data, get information about the structure of the fields, and display your findings in a visualization. You can also customize and save your Discover sessions and place them on a dashboard.
+Key capabilities:
+
+- Search with KQL, Lucene, or {{esql}} queries
+- Analyze field statistics and distributions
+- Create visualizations from your data
+- Save searches for reuse and sharing
+- Run pattern analysis on log data
+- Get Context-aware experiences for logs, metrics, and traces
+- Run Background search for long-running queries
 
 :::{image} /explore-analyze/images/kibana-hello-field.png
 :alt: A view of the Discover app

@@ -7,20 +7,20 @@ applies_to:
   serverless: unavailable
 products:
   - id: kibana
-description: Send your long-running queries to run in the background with background searches and search sessions, and focus on your other tasks while they complete.
+description: Send long-running queries to run in the background with background searches from Discover and Dashboards. Continue working while queries complete and access results later.
 ---
 
-# Run Discover and Dashboards queries in the background
+# Run Discover and Dashboards queries in the background [background-search]
 
 ::::{important} - Background search replaces Search sessions
 
 Background search is a feature introduced in version 9.2. It replaces the deprecated **Search sessions** feature.
 If you have been using search sessions and upgrade to 9.2, your search sessions aren't lost and become background searches.
 ::::
 
-Sometimes you might need to search through large amounts of data, no matter how long the search takes. Consider a threat hunting scenario, where you need to search through years of data. 
+Sometimes you might need to search through large amounts of data, no matter how long the search takes. Consider a threat hunting scenario, where you need to search through years of data.
 
-You can send your long-running searches to the background from **Discover** or **Dashboards** and let them run while you continue your work. 
+You can send your long-running searches to the background from **Discover** or **Dashboards** and let them run while you continue your work.
 
 You can access your list of background searches at any time to check their status and manage them from the {icon}`background_task` **Background searches** button in the toolbar.
 

@@ -6,21 +6,18 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Step-by-step tutorial for exploring data with Discover by selecting data views, filtering documents, analyzing fields, and creating visualizations using sample or your own data.
 ---
 
 # Explore fields and data with Discover [discover-get-started]
 
-Learn how to use **Discover** to:
+**Discover** provides a flexible interface for exploring your {{product.elasticsearch}} data. Learn how to select and filter data, explore field structures and document content, and present your findings in visualizations. This tutorial walks you through the core workflows for analyzing data in **Discover**, from loading data to creating and saving visualizations.
 
-* **Select** and **filter** your {{es}} data.
-* **Explore** the fields and content of your data in depth.
-* **Present** your findings in a visualization.
+## Prerequisites
 
-**Prerequisites:**
-
-* If you don’t already have {{kib}}, [start a free trial](https://www.elastic.co/cloud/elasticsearch-service/signup?baymax=docs-body&elektra=docs) on Elastic Cloud.
-* You must have data in {{es}}. Examples on this page use the [ecommerce sample data set](../index.md#gs-get-data-into-kibana), but you can use your own data.
-* You should have an understanding of [{{es}} documents and indices](../../manage-data/data-store/index-basics.md).
+* Access to {{product.kibana}}. If you don't already have {{product.kibana}}, [start a free trial](https://www.elastic.co/cloud/elasticsearch-service/signup?baymax=docs-body&elektra=docs) on Elastic Cloud.
+* Data in {{product.elasticsearch}}. Examples on this page use the [ecommerce sample data set](../index.md#gs-get-data-into-kibana), but you can use your own data.
+* Understanding of [{{product.elasticsearch}} documents and indices](../../manage-data/data-store/index-basics.md).
 
 ## Context-aware data exploration [context-aware-discover]
 

@@ -6,13 +6,20 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Sort search results by relevance score in Discover to identify the documents that best match your query. Use the score field to prioritize the most relevant data.
 ---
 
 # Search for relevance [discover-search-for-relevance]
 
-{{es}} assigns a relevancy, or score to each document, so you can can narrow your search to the documents with the most relevant results. The higher the score, the better it matches your query.
+{{product.elasticsearch}} assigns a relevancy score to each document based on how well it matches your query. Sorting by this score helps you identify the most relevant results quickly. This guide shows how to use **Discover** to sort documents by relevance score, putting the best matches at the top of your results.
 
-This example shows how to use **Discover** to list your documents from most relevant to least relevant. This example uses the [sample flights data set](../index.md#gs-get-data-into-kibana), or you can use your own data.
+## Requirements
+
+- Access to {{product.kibana}}
+- A {{data-source}} with searchable data
+- Understanding of basic search queries
+
+This example uses the [sample flights data set](../index.md#gs-get-data-into-kibana), or you can use your own data.
 
 1. In **Discover**, open the {{data-source}} dropdown, and select the data that you want to work with.
 

@@ -6,11 +6,17 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Customize the Discover view with flexible display options for the document table, chart, and sidebar. Adjust columns, density, row height, and field visibility for optimal exploration.
 ---
 
 # Customize the Discover view [document-explorer]
 
-Fine tune your explorations by customizing **Discover** to bring out the the best view of your documents.
+**Discover** offers flexible customization options to optimize your data exploration experience. Adjust the document table layout, modify column arrangements, control chart and sidebar visibility, and configure display density to focus on the data that matters most. These customizations persist across sessions and help you work more efficiently with your {{product.elasticsearch}} data.
+
+## Requirements
+
+- Access to {{product.kibana}}
+- A {{data-source}} with data to explore
 
 :::{tip}
 Discover provides default [context-aware experiences](/explore-analyze/discover/discover-get-started.md#context-aware-discover) tailored to the type of data that you're exploring, and you can further customize your Discover view on top of them.

@@ -6,15 +6,20 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Detect patterns in unstructured data with pattern analysis in Discover. Categorize log messages, identify common structures, and filter noise during troubleshooting.
 ---
 
 # Run a pattern analysis on your log data [run-pattern-analysis-discover]
 
-Log pattern analysis helps you to find patterns in unstructured log messages and makes it easier to examine your data. It performs categorization analysis on a selected field of a {{data-source}}, creates categories based on the data and displays them together with a chart that shows the distribution of each category and an example document that matches the category.
+Pattern analysis in **Discover** helps you find patterns in unstructured log messages by performing categorization analysis on text fields. It creates categories based on message structures, displays their distribution in a chart, and provides example documents for each pattern. This makes it easier to identify common log patterns, filter out noise, and focus on anomalous messages during troubleshooting.
 
-Log pattern analysis works on every text field.
+## Requirements
 
-This example uses the [sample web logs data](../index.md#gs-get-data-into-kibana), or you can use your own data.
+- Access to {{product.kibana}}
+- A {{data-source}} with log data containing text fields
+- Understanding of basic log analysis concepts
+
+Pattern analysis works on any text field. This example uses the [sample web logs data](../index.md#gs-get-data-into-kibana), or you can use your own data.
 
 1. Go to **Discover**.
 2. Expand the {{data-source}} dropdown, and select **Kibana Sample Data Logs**.

@@ -7,11 +7,18 @@
   serverless: ga
 products:
   - id: kibana
+description: Save Discover sessions to reuse searches, queries, and configured views. Add saved searches to dashboards or use them as a foundation for building visualizations.
 ---
 
 # Discover sessions: Save a search for reuse [save-open-search]
 
-A saved Discover session is a convenient way to reuse a search that you’ve created in **Discover**. Discover sessions are good for saving a configured view of Discover to use later or adding search results to a dashboard, and can also serve as a foundation for building visualizations.
+Saved Discover sessions preserve your queries, filters, column selections, and view configurations for reuse. Save sessions to return to specific data explorations, share search results with team members, add searches to dashboards, or use them as a foundation for building visualizations. This guide shows how to save, reopen, duplicate, and manage Discover sessions.
+
+## Requirements
+
+- Access to {{product.kibana}}
+- Permissions to save {{product.kibana}} objects (see [Read-only access](#discover-read-only-access))
+- A configured view in **Discover** worth saving
 
 
 ## Read-only access [discover-read-only-access]

@@ -6,14 +6,18 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Explore field statistics in Discover to view distributions, top values, and data quality metrics. Analyze numeric ranges, geographic coordinates, and field cardinality.
 ---
 
 # View field statistics [show-field-statistics]
 
-Explore the fields in your data with the **Field statistics** view in **Discover** and answer such questions as:
+The **Field statistics** view in **Discover** provides statistical summaries and visualizations of your data fields. View distributions, top values, minimum and maximum ranges, and cardinality to quickly understand your data quality and patterns. Use field statistics to identify data issues, understand field characteristics, and discover insights before building visualizations.
 
-* What does the latency look like when one of the containers is down on a Sunday?
-* Is the field type and format in the data view appropriate for the data and its cardinality?
+## Requirements
+
+- Access to {{product.kibana}}
+- A {{data-source}} with data to analyze
+- **Discover** in default mode (field statistics aren't available in {{esql}} mode)
 
 :::{note}
 Field statistics aren't available when **Discover** is in {{esql}} mode.

@@ -6,24 +6,24 @@ applies_to:
   serverless: ga
 products:
   - id: kibana
+description: Step-by-step tutorial for querying data with ES|QL in Discover using piped commands to filter, transform, and aggregate data with sample data and visualizations.
 ---
 
 # Using ES|QL [try-esql]
 
-The Elasticsearch Query Language, {{esql}}, makes it easier to explore your data without leaving Discover.
+Elasticsearch Query Language ({{esql}}) makes it easier to explore and analyze your {{product.elasticsearch}} data directly in **Discover**. {{esql}} uses a piped syntax where you chain commands together to filter, transform, and aggregate data without needing to switch between different query interfaces. This tutorial walks you through querying sample data with {{esql}}, from basic field selection to complex filtering and visualization.
 
-The examples on this page use the {{kib}} sample web logs in Discover and Lens to explore the data and create visualizations. You can also install it by following [Add sample data](../index.md#gs-get-data-into-kibana).
-
-::::{tip}
-For the complete {{esql}} documentation, including all supported commands, functions, and operators, refer to the [{{esql}} reference](elasticsearch://reference/query-languages/esql/esql-syntax-reference.md). For a more detailed overview of {{esql}} in {{kib}}, refer to [Use {{esql}} in Kibana](../query-filter/languages/esql-kibana.md).
-
-::::
+## Prerequisites
 
+- Access to {{product.kibana}}
+- The `enableESQL` setting enabled in **Advanced Settings** (enabled by default)
+- Sample data installed (optional but recommended for following examples)
 
+The examples on this page use the {{product.kibana}} sample web logs to explore data and create visualizations. You can install sample data by following [Add sample data](../index.md#gs-get-data-into-kibana).
 
-## Prerequisite [prerequisite]
-
-To view the {{esql}} option in **Discover**, the `enableESQL` setting must be enabled from Kibana’s **Advanced Settings**. It is enabled by default.
+::::{tip}
+For the complete {{esql}} documentation, including all supported commands, functions, and operators, refer to the [{{esql}} reference](elasticsearch://reference/query-languages/esql/esql-syntax-reference.md). For a more detailed overview of {{esql}} in {{product.kibana}}, refer to [Use {{esql}} in Kibana](../query-filter/languages/esql-kibana.md).
+::::
 
 
 ## Use {{esql}} [tutorial-try-esql]

@@ -84,7 +84,7 @@ There are three types of **Discover** interactions you can add to dashboard pane
 
     To use series data interactions, click a data series in the panel.
 
-* **Discover session interactions** — Opens [saved Discover session](../discover.md#save-your-search) data in **Discover**.
+* **Discover session interactions** — Opens [saved Discover session](../discover/save-open-search.md) data in **Discover**.
 
     To use saved Discover session interactions, open the panel menu and click **View Discover session**.