// troubleshooting guide · apache superset
Superset Embedded Dashboard Not Loading (403 or Refused to Connect)
- Status
- Workaround available
- platforms:
- Self-hosted, Preset
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · apache-superset/embedded-dashboard-not-loading5 FIXES
// quick answer
Embedded Superset dashboards fail when the EMBEDDED_SUPERSET flag is off, the host domain is not allowed, Talisman blocks framing, or the guest role lacks dataset access. Fix each layer in that order.
Most likely fix: Enable embedding
How to fix it
// try these in order, the most common fix is first
FIX 1Enable embedding
- 01Add 'EMBEDDED_SUPERSET': True to FEATURE_FLAGS
- 02Open the dashboard > ... > Embed dashboard
- 03Add your app's origin under Allowed Domains
Did this fix it?FIX 2Allow framing
- 01In TALISMAN_CONFIG add your app origin to frame-ancestors
- 02Avoid disabling Talisman entirely in production
Did this fix it?FIX 3Give the guest role access
- 01Set GUEST_ROLE_NAME to a role that has datasource access on every dataset the dashboard uses
- 02In 6.x, check API permissions such as can read on CurrentUserRestApi
Did this fix it?FIX 4Refresh guest tokens
- 01Request tokens from your backend via /api/v1/security/guest_token/
- 02Use fetchGuestToken in the SDK so it refreshes before GUEST_TOKEN_JWT_EXP_SECONDS
Did this fix it?FIX 5Check server logs
- 01Guests only see a generic error; the real cause is in Superset logs
Did this fix it?
SANDBOX · apache-superset RUNS IN YOUR BROWSER
Try it: browse a sample shop and watch visitors, funnels and live data arrive
A hands-on Apache Superset-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
The iframe shows 'refused to connect', a login page, a blank area, 403 errors on chart or /api/v1/me/roles/ requests, or 'An error occurred while fetching the data'.
Why it happens
- C-01EMBEDDED_SUPERSET feature flag disabled
- C-02Host origin not in the dashboard's Allowed Domains
- C-03Talisman sets X-Frame-Options SAMEORIGIN / CSP frame-ancestors
- C-04Guest role missing datasource or API permissions
- C-05Guest token expired (5 minute default)
- C-06Third-party cookies blocked in cross-site iframes
// this guide also covers
- superset embedded dashboard 403
- superset iframe refused to connect
- superset guest token not working
- superset embed dashboard not loading
Still not working?
If Apache Superset keeps failing, you're not alone. See every Apache Superset problem users report or the alternatives people switch to.
Done fighting Apache Superset? Our small team builds your own Apache Superset alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
Metabase Dashboard Slow or Not Loading (Metabase)
Power BI Gateway Offline or Could Not Be Reached (Microsoft Power BI)
Tableau "Unable to Start Due to an Internal Licensing Error" (Tableau)
Looker Studio GA4 Quota Exceeded Error (Looker Studio)
Other Apache Superset errors
- Superset CSRF Session Token Is Missing Error
- Superset Dashboard Slow or Charts Timing Out
- Superset Refusing to Start Due to Insecure SECRET_KEY
- Superset Alerts and Reports Not Sending Emails
- Superset Could Not Load Database Driver
- Superset CSV Upload Option Missing
- Superset Forgot Admin Password (How to Reset Login)
- Superset Dashboards Broken After Upgrade