Skip to content

docs: update dashboard panel workflows for the Add to dashboard flyout (#6353)#7189

Draft
florent-leborgne wants to merge 1 commit into
mainfrom
docs-issue-6353-add-to-dashboard-flyout
Draft

docs: update dashboard panel workflows for the Add to dashboard flyout (#6353)#7189
florent-leborgne wants to merge 1 commit into
mainfrom
docs-issue-6353-add-to-dashboard-flyout

Conversation

@florent-leborgne

Copy link
Copy Markdown
Member

Summary

This PR addresses #6353. In 9.5, clicking Add on a dashboard no longer opens a popover; it opens a single Add to dashboard flyout with New and From library tabs, featured Visualization and Visualization (query) items, a renamed Other visualizations group (was "Visualizations"), and Vega (was "Custom visualization"). These changes update the affected panel-adding workflows across the docs, using the cumulative model so earlier-version steps are preserved.

  • explore-analyze/visualize.md: Adds a canonical description of the Add to dashboard flyout (New / From library tabs, featured items, grouped panel types), updates "Add panel" flow/menu wording to the version-neutral Add menu, and renames the panel-type entry to Vega.
  • explore-analyze/dashboards/drilldowns.md: Adds a 9.5+ flyout variant for the "add from library" and "create visualization" steps and caps the popover wording at 9.2–9.4 (issue-requested).
  • explore-analyze/visualize/esorql.md, _snippets/emoji-table-esql.md, kibana-data-exploration-learning-tutorial.md: Updates the ES|QL panel steps — the removed New panel item and the renamed Other visualizations group — to use the Visualization (query) featured item in 9.5+.
  • explore-analyze/visualize/link-panels.md, text-panels.md, image-panels.md, alert-panels.md: Normalizes the "add a panel" / "add from library" steps to the flyout, with cumulative version bullets.
  • explore-analyze/discover/save-open-search.md: Updates the "create a Discover session on the dashboard" steps (Discover session now sits under Other visualizations in 9.5+).
  • explore-analyze/visualize/custom-visualizations-with-vega.md: Renames Custom visualization to Vega (label change verified in source).

All UI strings were verified against elastic/kibana at origin/main (HEAD), not just the original PR diff — see note below.

Resolves

Closes #6353

Verification notes

  • Feature shipped in elastic/kibana#264457 (v9.5.0). A follow-up, elastic/kibana#271437, moved the two featured items from a hardcoded list to actions on a FEATURED_ADD_PANEL_TRIGGER; the visible result is unchanged, but the original PR's featured_menu_items.ts no longer exists, so all labels were re-confirmed at HEAD.
  • Confirmed strings: Add button, Add to dashboard flyout, New / From library tabs, Visualization ("Build charts, metrics, and tables with a point-and-click editor."), Visualization (query) ("Build charts, metrics, and tables with ES|QL."), Other visualizations group, Vega. Discover session is registered under ADD_PANEL_VISUALIZATION_GROUP (Other visualizations).

Out of scope (intentional)

  • Tutorial steps that read Select **Add** > **Visualization** in create-dashboard-of-panels-with-ecommerce-data.md and create-dashboard-of-panels-with-web-server-data.md were left unchanged: the label path still resolves correctly in the 9.5 flyout (Add, then the Visualization featured item).
  • add-controls.md (Add > Controls > …) was left unchanged; the controls flow is a separate area not covered by this redesign issue.
  • create-dashboard.md was left unchanged: it describes panel-adding at a high level and links to visualize.md, where the flyout is now documented.

Screenshots to add or update

  • explore-analyze/visualize.md — new Add to dashboard flyout: consider adding a screenshot of the flyout (New tab with featured items) since it is a new, visually distinct surface for evaluators and new users. Prose describes it, but the layout is easier to grasp visually.

AI-generated draft — created with Claude Opus 4.8.
Review all generated content for factual accuracy before merging.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


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.

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.

Add to dashboard flyout redesign with New and From Library tabs

1 participant