Embedding dashboards

Share a dashboard outside UnitOps, for example inside an intranet page or a franchisee portal, using a signed embed URL.

Page: Admin -> Embed (/admin/embed) · Role required: admin

Generate an embed

1. Go to Admin -> Embed.
2. Choose the dashboard to embed.
3. Enter a label describing where it will live, for example Franchise portal - weekly sales. The page refuses to continue without one.
4. Select the locations the embed is allowed to show.
5. Click Generate Embed Code.

You get:

• Copy URL - the direct signed URL.
• Copy iframe snippet - a ready-to-paste <iframe>.
• Preview in new tab - open exactly what a viewer sees.
• Test embed URL reachability - confirms the URL responds from outside the app.

Paste it into your site

<iframe
  src="https://unitops.datalakehouse.io/embed/<token>"
  width="100%"
  height="800"
  style="border:0"
  loading="lazy"
></iframe>

How the token works

• The token is HMAC-signed and carries the dashboard, the allowed locations, and an expiry.
• Default lifetime is 7 days; the maximum is 1 year.
• The dashboard's metadata.platform.allow_embed must be true, see Custom dashboards.
• Viewers do not sign in, so treat the URL as a secret: anyone with the link sees the data until the token expires.

Rotate or revoke

Generate a new embed and replace the URL where it is published. Old tokens stop working once they expire; issue short-lived tokens for anything sensitive.

Troubleshooting

Symptom	Fix
"Failed to generate embed token"	The dashboard does not allow embedding; set allow_embed: true and publish again
"Failed to reach embed URL"	The host is blocked by network policy, or the token already expired
Blank iframe	The parent page blocks framing; check its content security policy
Wrong locations shown	Regenerate the embed with the correct location selection