Skip to content

Conversation

florent-leborgne
Copy link
Contributor

@florent-leborgne florent-leborgne commented Oct 10, 2025

This PR:

  • Adds a section about creating variable controls in Discover, with sub-sections on how to edit them and how to bring these controls over to a dashboard
  • Transforms certain pieces of content into content snippets that are shared between Discover and Dashboards docs as variable controls are used in both apps: code examples, control parameters.
  • Adds the section about "how to bring Discover sessions along with their controls to a dashboard" to the "Add controls" page in dashboards docs as well. This content is single-sourced so only maintained in one place.
  • Re-adds a "preview" flag to the Variable controls section in dashboard docs, that one was mistakenly removed in another PR

Find page previews in one of the comments below

Note: Tested on staging environment on Oct 10

Closes: #3096

Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive documentation for variable controls in Discover, enabling users to create dynamic queries with reusable controls that can be shared between Discover and Dashboards.

  • Adds new section documenting how to create, edit, and use variable controls in Discover
  • Creates shared content snippets for variable control configuration and examples to reduce duplication
  • Documents the workflow for importing Discover queries with controls into dashboards

Reviewed Changes

Copilot reviewed 5 out of 7 changed files in this pull request and generated no comments.

Show a summary per file
File Description
explore-analyze/discover/try-esql.md Adds complete variable controls documentation for Discover including creation, editing, and dashboard import
explore-analyze/dashboards/add-controls.md Updates dashboard controls documentation to use shared snippets and adds import workflow
explore-analyze/_snippets/variable-control-form.md Creates shared snippet for variable control configuration parameters
explore-analyze/_snippets/variable-control-examples.md Creates shared snippet with ESQL query examples using variable controls
explore-analyze/_snippets/import-discover-query-controls-into-dashboard.md Creates shared snippet documenting the import workflow from Discover to Dashboard

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copy link

github-actions bot commented Oct 10, 2025

🔍 Preview links for changed docs

Copy link
Contributor

@stratoula stratoula left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lovely! Added some small comments, nothing crucial

florent-leborgne and others added 2 commits October 10, 2025 14:57
Co-authored-by: Stratou <stratoula1@gmail.com>
Co-authored-by: Stratou <stratoula1@gmail.com>
Copy link
Contributor

@benironside benironside left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, left some suggestions for your consideration! Hope they're helpful

…dashboard.md

Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
florent-leborgne and others added 2 commits October 11, 2025 08:05
Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
…dashboard.md

Co-authored-by: Benjamin Ironside Goldstein <91905639+benironside@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Kibana ES|QL][Discover] Controls in Discover

3 participants