Skip to main content
Iframe embedding is available on Premium and Enterprise plans.
Embed any dashboard into your application using an iframe. Dashboards can be embedded with either authentication mode:
  • Private embedding — for internal users with Cube accounts (e.g., embedding in Notion, Salesforce, internal tools)
  • Signed embedding — for external/customer-facing applications using server-generated sessions

​
Embed with private embedding

To embed a dashboard for internal users:
  1. Open your dashboard in Cube
  2. Click Share → Embed
  3. Copy the generated iframe code
Share embed dialog Then paste the iframe code into your application:
Users will be prompted to sign in with their Cube credentials when accessing the embedded dashboard. See Private embedding for details on the auth model and integration examples (Notion, Salesforce).

​
Embed with signed embedding

Signed embedding must be allowed on the dashboard first: open the dashboard, click Share → Embed, and turn on Allow signed embedding. You can also toggle it without opening the UI using the Cube CLI:
To embed a dashboard for external/customer-facing applications, generate a session on your backend and pass the session ID into the iframe:
See Signed embedding for the full session generation flow, API key setup, and a complete working example.

​
Pre-set dashboard filters via URL

You can pre-set dashboard filter values by adding URL parameters in the format ?f_<semantic_view>.<dimension>=<JSON>. The <semantic_view> and <dimension> must match the internal names (not display titles) of the semantic view and dimension configured on the filter widget. If the filter type is omitted, it defaults to equals. Example:
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 widget export

By default, embedded dashboards do not expose a download action on individual widgets. To let viewers download a chart widget, add the allowExport=true query parameter to the embed URL:
When enabled, each chart widget’s ⋮ menu shows Download as CSV, Download as PNG, and Download as PDF. The CSV is generated client-side from the data already loaded into the widget; PNG and PDF are rendered server-side, so they work even before the widget has finished loading in the browser. The parameter is opt-in — omit it (the default) to keep the download actions hidden. A tenant’s Restrict data downloads admin lock, if enabled, overrides allowExport and hides all three actions regardless of the URL parameter. Only one export can run at a time per dashboard. Starting a second export while one is still in progress shows “Another export is still running. Wait for it to finish and try again.”

​
Show or hide the AI chat

Embedded dashboards show an AI chat (the agent panel and its launcher bubble) by default. You can control it in two ways:
  • Globally, in the UI. Toggle Show dashboard chat under Embed → Settings in the Cube Cloud console. This switch is account-wide — it turns the AI chat on or off for the entire embedded surface, i.e. every embedded dashboard.
  • Per session, via the API. Pass settings.showDashboardChat when you generate the session. A per-session value takes precedence over the global toggle — false hides the chat for that session even when it is enabled account-wide, and true shows it even when it is disabled:
This applies to embedded published dashboards; it does not affect the standalone Analytics Chat surface, where embedding the chat is itself the opt-in.

​
Set the language

Embedded dashboards render their UI in the account’s default language, which you can override per embed by adding the ?locale= query parameter:
See Localization for the list of supported languages and the other ways to set the language.

​
Customize appearance

You can style an embedded dashboard — background, padding, widget borders, titles, and fonts — from the Styling panel in the Dashboard Builder. See Dashboards → Styling for the full list of options.