// troubleshooting guide · apache superset

Superset deck.gl Map Not Showing

Status
Workaround available
platforms:
Self-hosted
updated:
November 16, 2026
reports:
3
Method
how we research
Share

RUNBOOK · apache-superset/deck-gl-map-not-showing3 FIXES

// quick answer

A blank deck.gl or map chart usually means MAPBOX_API_KEY is missing or the Content Security Policy blocks Mapbox. Set the key, allow Mapbox hosts in Talisman, or switch the base map to OpenStreetMap.

Most likely fix: Set the Mapbox key

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Set the Mapbox key

    1. 01Create a token at mapbox.com
    2. 02Set MAPBOX_API_KEY in superset_config.py or as an environment variable (docker/.env for Docker)
    3. 03Restart Superset
    Did this fix it?
  2. FIX 2Allow Mapbox in CSP

    1. 01Add https://api.mapbox.com and https://events.mapbox.com to connect-src in TALISMAN_CONFIG
    2. 02Reload and check the browser console for blocked requests
    Did this fix it?
  3. FIX 3Use OpenStreetMap tiles

    1. 01Configure DECKGL_BASE_MAP in superset_config.py with an OSM tile layer
    2. 02OSM tiles work without a key
    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

deck.gl charts show points on a grey or empty background, or the map area stays blank.

Why it happens

  • C-01MAPBOX_API_KEY not set or invalid
  • C-02TALISMAN_CONFIG connect-src missing api.mapbox.com and events.mapbox.com
  • C-03Config change without restarting Superset

// this guide also covers

  • superset deck.gl map not showing
  • superset mapbox api key
  • superset map blank
  • superset map chart not working

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 missing or lost data guides →

Other Apache Superset errors

All 14 Apache Superset errors and fixes →