Dashboard Embeds let you share any dashboard with an external audience by generating a shareable URL or an iframe snippet. The embedded dashboard is read-only — viewers can interact with charts and apply filters, but cannot edit anything.
Embeds are for sharing a specific dashboard. If you want to deliver a fully branded, multi-feature analytics experience to your own users under your own domain, see White Label instead.
Opening the Embed Panel
Open a dashboard and click the Export button in the top-right toolbar. The export panel slides open on the right side. Select the Embeds tab.
From here you can create new embed tokens and manage existing ones for this dashboard group.
Creating an Embed
Click Add New Embedding to open the creation form. Configure the options below, then click Create to generate the embed token and URL.
The embed URL is displayed immediately after creation. Copy it to your clipboard or embed it as an iframe in your product.
Expiration
Every embed has an expiry date — the date and time after which the embed token becomes invalid and the URL stops working.
| Detail | Behaviour |
|---|
| Default | 14 days from the date of creation |
| Configurable | Pick any future date and time using the date picker |
| Past dates | Disabled — expiry must be in the future |
Set a longer expiry for permanent, public-facing embeds. Use short expiry windows for temporary previews or client reviews.
Domain Restriction
By default, an embed is accessible to anyone with the link. You can restrict it to specific domains so it only loads when embedded on your approved sites.
Add one or more domains to the Domains field (e.g. yourcompany.com, app.yourcompany.com). Each domain is validated for format.
| Configuration | Behaviour |
|---|
| No domains set | Embed is publicly accessible to anyone with the URL |
| One or more domains set | Embed only loads when accessed from those domains |
Filter Configuration
If your dashboard has Filter widgets, you can control how each one behaves in the embed — whether viewers see it, whether it affects the data, and what value it starts with.
Per-filter options
For each filter widget on the dashboard, three settings are available:
Visibility
| State | What happens |
|---|
| Visible (default) | The filter is shown to viewers and they can change it |
| Hidden | The filter is not shown in the UI, but it still filters the data — viewers see pre-filtered results without knowing a filter is active |
Enabled / Disabled
| State | What happens |
|---|
| Enabled (default) | The filter actively affects the query results |
| Disabled | The filter is completely inactive — it does not filter the data at all, regardless of any preset value |
Preset value
Set a default value that the filter starts with when the embed loads. Viewers can change it (if the filter is visible and enabled). Preset values are type-aware:
| Filter type | Preset input |
|---|
| Categorical | Multi-select dropdown or text |
| Date | Date picker (supports single date, range, month, quarter, year) |
| Text | Text input |
| Numeric / Integer | Number input |
| Boolean | Toggle |
Common filter patterns
Lock viewers to a specific customer’s data:
Set the relevant filter to Hidden + Enabled + a preset value equal to that customer’s ID. Viewers see only their data and cannot change or see the filter.
Show a filter but pre-populate it:
Set the filter to Visible + Enabled + a preset value. Viewers start with a useful default but can adjust it.
Turn off a filter entirely for this embed:
Set the filter to Disabled. The filter has no effect — useful when an embed is scoped to data where the filter is irrelevant.
Hide Dashboard Title
Toggle Hide Title to remove the dashboard name from the top of the embedded view. Useful when you are embedding the dashboard inside your own product that already provides the context.
Interactive Mode (Ask Stella in Embeds)
Pro feature. Interactive Mode requires a plan that includes the interactive_mode capability. An upgrade prompt is shown if it is not available on your current plan.
When enabled, a Stella AI chat interface is available to viewers inside the embedded dashboard — allowing them to ask natural language questions about the data they’re viewing.
| Field | Description |
|---|
| Enable Interactive Mode | Toggle on to add Stella to the embed |
| Agent | Select which agent powers the Stella interface. Choose from the agents configured in your workspace. |
Managing Existing Embeds
All existing embed tokens for the current dashboard group are listed in the Embeds tab.
Each embed shows:
- Domain icons — the sites the embed is restricted to, or “All Domains” if unrestricted
- Expiry date — formatted as “Expires on ”
- Embed URL — truncated display of the full URL
- Copy button — copy the embed URL to the clipboard
- Delete button — permanently revoke the embed token
Revoking an embed
Click Delete on any embed to revoke it immediately. The token becomes invalid and the URL stops working for anyone who has it. This cannot be undone — create a new embed token if access needs to be restored.
What Viewers See
Embedded dashboards open in a clean, read-only view:
- All widgets (charts, KPIs, tables, text, images, memos, embeds) are fully rendered
- Viewers can hover on charts for tooltips and click data points to drill through
- Filter widgets (if visible and enabled) are interactive — viewers can change filter values
- The dashboard title is shown or hidden based on your Hide Title setting
- If Interactive Mode is on, a Stella chat interface is available alongside the dashboard
- No edit controls, widget menus, or toolbar options are shown
- Viewers do not need a Supaboard account to access an unrestricted embed
Permissions
| Action | Minimum role |
|---|
| Open the Embed panel | Editor |
| Create an embed token | Editor |
| Copy an embed URL | Editor |
| Delete / revoke an embed token | Editor · Admin · Owner |
| Enable Interactive Mode | Editor (requires Pro plan feature) |
Last modified on March 11, 2026
