// 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
Share

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

  1. FIX 1Enable embedding

    1. 01Add 'EMBEDDED_SUPERSET': True to FEATURE_FLAGS
    2. 02Open the dashboard > ... > Embed dashboard
    3. 03Add your app's origin under Allowed Domains
    Did this fix it?
  2. FIX 2Allow framing

    1. 01In TALISMAN_CONFIG add your app origin to frame-ancestors
    2. 02Avoid disabling Talisman entirely in production
    Did this fix it?
  3. FIX 3Give the guest role access

    1. 01Set GUEST_ROLE_NAME to a role that has datasource access on every dataset the dashboard uses
    2. 02In 6.x, check API permissions such as can read on CurrentUserRestApi
    Did this fix it?
  4. FIX 4Refresh guest tokens

    1. 01Request tokens from your backend via /api/v1/security/guest_token/
    2. 02Use fetchGuestToken in the SDK so it refreshes before GUEST_TOKEN_JWT_EXP_SECONDS
    Did this fix it?
  5. FIX 5Check server logs

    1. 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 us

Watch Apache Superset Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Apache Superset errors

All 14 Apache Superset errors and fixes →