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 all commits
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.
19 changes: 13 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,27 @@ 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 {#allow-csv-export}

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 — so they can take up to a couple of minutes for large widgets,
and only one export can run at a time per dashboard (a second attempt is
rejected as "another export still running" rather than failing outright). The
parameter is opt-in — omit it (the default) to keep the download action
hidden; it is also hidden entirely when an admin turns off the account-wide
[data download controls](/admin/users-and-permissions/roles-and-permissions#restricting-data-downloads).

## Show or hide the AI chat

Expand Down
4 changes: 2 additions & 2 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,8 +209,8 @@ 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
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-csv-export)). The event fires when a
viewer uses it.
</Note>
Expand Down