diff --git a/guides/embedding/dashboards.mdx b/guides/embedding/dashboards.mdx index 0650a767..75867074 100644 --- a/guides/embedding/dashboards.mdx +++ b/guides/embedding/dashboards.mdx @@ -21,7 +21,8 @@ Dashboard embedding allows you to display full Lightdash dashboards in your appl ### Key features -- Multiple chart tiles and markdown content ([see limitations](#limitations)) +- Multiple chart tiles, including saved charts and SQL Runner charts +- Markdown, loom, and heading tiles - Dashboard-level filters (interactive if enabled) - Multiple tabs for organizing content - Parameters support @@ -30,14 +31,9 @@ Dashboard embedding allows you to display full Lightdash dashboards in your appl - "Explore from here" to navigate to query builder - View underlying data for any visualization -### Limitations - - -**SQL chart tiles are not supported in embedded dashboards.** Only saved charts created via **Explore** will render. Dashboards containing tiles built in the SQL Runner will fail to load. - - -- **Symptom:** An embedded dashboard that includes SQL chart tiles surfaces an `Account is not a registered user` error at runtime. This happens because the SQL chart endpoints require a registered Lightdash user, and embed JWT users are anonymous. -- **Workaround:** Rebuild the SQL Runner queries as regular saved charts via **Explore** against the same modeled tables, then replace the SQL chart tiles on the dashboard. + +SQL Runner chart tiles are authorized through dashboard-tile membership, so they work with existing embed JWTs — you do not need to regenerate tokens or change embed URLs to render them. SQL charts remain embeddable only as part of a dashboard; chart-scoped JWTs (`type: 'chart'`) cannot embed a SQL chart on its own. + ## Setup