Skip to content

docs: document the SQL fallback editor and embedded PNG/PDF export #11624

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
keydunov wants to merge 3 commits into
base: master
Choose a base branch
from
+22 −8
Open

docs: document the SQL fallback editor and embedded PNG/PDF export #11624

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6452e22
docs: document the SQL fallback editor and embedded PNG/PDF export
claude Aug 23, 2026
426bb19
docs: keep the #allow-csv-export anchor stable after the heading rename
claude Aug 23, 2026
31546ff
docs: carry over export latency and data-download gating to embeds
claude Aug 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs-mintlify/docs/explore-analyze/workbooks/calculated-fields.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -149,3 +149,10 @@ not.

Select a calculated field in the sidebar to open the editor. You can change its
**name** and **SQL expression**, then choose **Update** to apply.

Fields generated from a column header menu—aggregations, **Calculations**
(**% of total**, **Running total**, etc.), and filtered measures—are edited
through a SQL-only editor instead: it shows just the Semantic SQL expression,
with no name field, since renaming isn't supported for these. Bucketed fields
(**Edit bins…**, **Edit groups…**) keep their own structured editor, described
above.
16 changes: 10 additions & 6 deletions docs-mintlify/embedding/iframe/dashboards.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,20 +77,24 @@ This works on both regular and published (embedded) dashboards. The filter is
only applied if a matching filter widget for that dimension already exists on the
dashboard.

## Allow CSV export
## Allow chart export
Comment thread
keydunov marked this conversation as resolved.
Outdated

By default, embedded dashboards do not expose a download action on individual
widgets. To let viewers download a chart widget's data as a CSV file, add the
widgets. To let viewers download a chart widget's data, add the
`allowExport=true` query parameter to the embed URL:

```text
https://your-tenant.cubecloud.dev/embed/dashboard/YOUR_DASHBOARD_PUBLIC_ID?session=YOUR_SESSION_ID&allowExport=true
```

When enabled, each chart widget's ⋮ menu shows a **Download as CSV** action. The
CSV is generated client-side from the data already loaded into the widget, so no
additional query is issued. The parameter is opt-in — omit it (the default) to
keep the download action hidden.
When enabled, each chart widget's ⋮ menu shows **Download as PNG**, **Download
as PDF**, and **Download as CSV** actions. CSV is generated client-side from
the data already loaded into the widget, so no additional query is issued. PNG
and PDF are server-rendered snapshots, the same mechanism used for
[dashboard export](/docs/explore-analyze/dashboards#download-as-png-or-pdf) in
the main app, and only one export can run at a time per dashboard. The
parameter is opt-in — omit it (the default) to keep the download action
hidden.
Comment thread
keydunov marked this conversation as resolved.
Outdated

## Show or hide the AI chat

Expand Down
6 changes: 3 additions & 3 deletions docs-mintlify/embedding/iframe/events.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,9 +209,9 @@ exported rows themselves.
```

<Note>
The CSV download action on a dashboard widget only appears when the embed URL
includes `allowExport=true` (see [Dashboards → Allow CSV
export](/embedding/iframe/dashboards#allow-csv-export)). The event fires when a
The download action on a dashboard widget only appears when the embed URL
includes `allowExport=true` (see [Dashboards → Allow chart
export](/embedding/iframe/dashboards#allow-chart-export)). The event fires when a
viewer uses it.
</Note>

Expand Down
Loading