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, click the … options button in the top-right toolbar, and select Embed. 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. A live preview renders inside the form as you configure it, so you can see the result before committing. The embed URL is displayed immediately after creation. Copy it to your clipboard or drop it into an iframe in your product.Title
An optional Title for the embed itself. This is a label for your own reference in the embed list — distinct from Hide Title, which controls whether the dashboard’s name is shown to viewers.Expiration
Every embed has an expiry date — the date and time after which the token becomes invalid and the URL stops working.
Once an embed token expires, anyone with the link sees an error. Create a new token to restore access.
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.
Domains are displayed with their favicon in the embed list for easy identification.
Display Options
Four controls sit together in the creation form:Filter Configuration
If your dashboard has Filter widgets, you can control how each one behaves in the embed. Each filter is a checkbox plus an optional preset value, and the combination of the two produces three behaviours:
The panel moves between these for you. Setting a preset on an unchecked filter switches it from excluded to hidden with preset; clearing that preset switches it back to excluded.
Preset value types
Date presets
Date filters offer 13 presets in four groups, plus a calendar for an explicit range:Presets are relative, so an embed set to Previous 30 days keeps showing the last 30 days indefinitely rather than freezing on the range that was current when you created it.
Common filter patterns
Lock viewers to a specific customer’s data: Leave the filter unchecked and set a preset equal to that customer’s ID. Viewers see only their data and cannot see or change the filter. Show a filter but pre-populate it: Check the filter and set a preset. Viewers start with a useful default but can adjust it. Turn off a filter entirely for this embed: Leave it unchecked with no preset. The filter has no effect — useful when an embed is scoped to data where the filter is irrelevant.Interactive Dashboard
Feature-gated. Interactive Dashboard requires the interactive mode feature on your plan. An upgrade prompt is shown otherwise — see pricing.“Ship your embedded dashboard with Stella that allows your users to interact with your dashboard.” When enabled, an AI chat interface is available to viewers inside the embedded dashboard, so they can ask natural language questions about the data they’re looking at. Turning it on reveals a Select Agent dropdown listing your workspace’s agents. Choose which agent answers. The agent is locked for the embed — viewers cannot switch it.
URL Parameters
Every setting saved on an embed can be overridden per-link with a query parameter. This lets one embed token serve several contexts without creating a token for each.Truthiness
For the boolean parameters (hide_page_selector, hide_title):
hide_title is genuinely an override, not a default: if the parameter is present it wins, regardless of what the embed was saved with. Omit it to fall back to the saved setting.
For thefilterandenvironmentparameters — how to build the token, and what the filter payload looks like — see Adding filters and environments to an embedded dashboard programmatically.
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
{date}” - 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 everyone who has it. This cannot be undone — create a new 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, embeds) are fully rendered
- Viewers can hover charts for tooltips and click data points to drill through
- Visible filter widgets are interactive
- The dashboard title is shown or hidden per the Hide Title setting and any
hide_titleparameter - Export controls appear only if Allow Export is on
- If Interactive Dashboard is on, an AI 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 open an unrestricted embed

