From e449be7e533fb398304c59ed70de3027b0bbae77 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 11:39:12 +0000 Subject: [PATCH] docs: note SQL chart tiles now render in embedded dashboards --- guides/embedding/dashboards.mdx | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) 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