Skip to content

docs: document Export JSON flyout for dashboards (#5909)#6034

Open
florent-leborgne wants to merge 8 commits intomainfrom
docs-issue-5909-export-json-flyout
Open

docs: document Export JSON flyout for dashboards (#5909)#6034
florent-leborgne wants to merge 8 commits intomainfrom
docs-issue-5909-export-json-flyout

Conversation

@florent-leborgne
Copy link
Copy Markdown
Member

@florent-leborgne florent-leborgne commented Apr 21, 2026

Summary

Documents the new Export JSON flyout that ships in elastic/kibana#255382 for Stack 9.4 and serverless (technical preview), and reframes the existing dashboard export content so readers can choose between the two formats.

Changes

  • explore-analyze/dashboards/sharing.md: Restructured the Export dashboards H2 into an umbrella section with a Format / Use it to / What it includes comparison table linking to two H3 subsections:

    • Export as NDJSON saved objects — the existing Saved Objects workflow, content unchanged.
    • Export as dashboards API-compatible JSON — new section documenting the toolbar Export > Export JSON flyout, the Unsupported properties were removed callout, the Open in Console Dev Tools handoff, and the Download JSON action. Tagged stack: preview 9.4 / serverless: preview to match the technical preview status of the feature.

    Also expanded the page meta description so it reflects both export formats.

  • explore-analyze/report-and-share.md: Added an Export JSON bullet to the Export as a file list, scoped to stack: preview 9.4 / serverless: preview, with a cross-link to the new H3 in the dashboard sharing page.

The existing NDJSON content is preserved verbatim under its new H3 so users on earlier versions still see the migration workflow they rely on.

Resolves

Closes #5909

Note on missing API links

The Kibana dashboards API is not yet publicly released. This PR therefore refers to the dashboards API in prose only, without hyperlinks. I'll add those in a later update.


AI-generated draft — created with Claude Sonnet 4.6 and iterated with reviewer feedback.
Review all generated content for factual accuracy before merging.

Made with Cursor

Adds documentation for the new Export JSON option in the dashboard
Export menu, which exports the dashboard state as API-compatible JSON.

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

github-actions Bot commented Apr 21, 2026

🔍 Preview links for changed docs

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 21, 2026

✅ Vale Linting Results

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.

Comment thread explore-analyze/dashboards/sharing.md Outdated
Comment thread explore-analyze/dashboards/sharing.md Outdated
Co-authored-by: Florent LB <florent.leborgne@elastic.co>
Adds a reciprocal pointer in the NDJSON Export dashboards section so
readers landing there discover the new JSON export option.

Made-with: Cursor
Improves discoverability by surfacing the JSON export option at the
start of the Export dashboards section.

Made-with: Cursor
…ctions

Promotes a single Export dashboards H2 with a comparison table that
helps readers choose between NDJSON and JSON, then moves the existing
NDJSON content and the new JSON content under H3 subsections with
descriptive titles. Updates the cross-link in report-and-share.md to
match the new H3 title.

Made-with: Cursor
Adds a What it includes column to the format comparison table and
removes the separate caveat sentence below it. The new column conveys
the JSON export's single-dashboard scope and the supported-panels
behavior without making the JSON export sound lossier than it is.

Made-with: Cursor
Comment thread explore-analyze/dashboards/sharing.md Outdated
Comment thread explore-analyze/dashboards/sharing.md Outdated
Co-authored-by: Florent LB <florent.leborgne@elastic.co>
Turns NDJSON and JSON into anchor links to the corresponding H3
subsections, and moves the JSON applies_to badges after the link so
the link text reads cleanly.

Made-with: Cursor
@florent-leborgne
Copy link
Copy Markdown
Member Author

florent-leborgne commented Apr 22, 2026

Hey @nickpeihl I just tested this and it's a nice feature. Can you take a look at this doc update? Because there's also the legacy saved object export option documented there, I've been wondering how to correctly compare these 2 options and tried to rework that a little bit. Let me know what you think :)

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.

Document Export JSON flyout for dashboards

1 participant