Skip to content

Document grouped view for ES|QL STATS results in Discover#5457

Draft
florent-leborgne wants to merge 2 commits intomainfrom
docs/discover-grouped-stats-results
Draft

Document grouped view for ES|QL STATS results in Discover#5457
florent-leborgne wants to merge 2 commits intomainfrom
docs/discover-grouped-stats-results

Conversation

@florent-leborgne
Copy link
Contributor

Summary

  • Adds a new "Explore STATS results in a grouped view" section to the Using ES|QL in Discover page.
  • Documents the Group by selector (with Technical Preview badge), expandable group rows, and row actions (Copy to clipboard, Filter in, Filter out, Open in new tab).
  • Describes conditions for the grouped view: requires STATS ... BY with a single BY field, not using grouping functions like BUCKET.
  • Includes a placeholder for a screenshot (commented out in the source).

Closes #4959

Availability check needed

The cascade/grouped view is gated behind a feature flag (discover.cascadeLayoutEnabled, which defaults to false in the code). We need to confirm:

  • Is this flag enabled by default in 9.4 / serverless production?
  • The UI shows a "Technical preview" badge (added in #255725), so the applies_to tag may need to be preview rather than ga.

Additional PRs merged since the original issue was filed (Feb 3)

The cascade feature has had significant ongoing development since the issue was created:

PR Description
#255725 Add tech preview badge to cascade switch button
#256630 Specify strict layout guidance for rows and cells
#251154 Support group by fetching across tabs
#248838 Improvements to cascade component from Discover usage
#251536 Resolve stuttering in cascade component
#253819 Add consideration for inline cast to cascade capture rules

Related Kibana PRs

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
  1. If you answered "Yes" to the previous question, please specify the tool(s) and model(s) used (e.g., Google Gemini, OpenAI ChatGPT-4, etc.).

Tool(s) and model(s) used: claude-4.6-opus-high in Cursor

Made with Cursor

Add a new section about the grouped (cascade) view that appears
when running STATS ... BY queries with a single BY field. Documents
the Group by selector, expandable rows, row actions, and conditions
for when the grouped view is available.

Made-with: Cursor
@github-actions
Copy link
Contributor

github-actions bot commented Mar 11, 2026

Vale Linting Results

Summary: 1 suggestion found

💡 Suggestions (1)
File Line Rule Message
explore-analyze/discover/try-esql.md 344 Elastic.Ellipses In general, don't use an ellipsis.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions
Copy link
Contributor

github-actions bot commented Mar 11, 2026

🔍 Preview links for changed docs

The actions are accessed via a row action button (three dots menu),
not a right-click context menu. Also fixes the icon name to
boxes_horizontal to match the docs-builder convention.

Made-with: Cursor
@florent-leborgne
Copy link
Contributor Author

This will stay as draft for now as the feature isn't fully released yet, only some code has shipped

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.

Grouped view for ES|QL query results in Discover when the query uses STATS

1 participant