// 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
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
FIX 1Set the Mapbox key
- 01Create a token at mapbox.com
- 02Set MAPBOX_API_KEY in superset_config.py or as an environment variable (docker/.env for Docker)
- 03Restart Superset
Did this fix it?FIX 2Allow Mapbox in CSP
- 01Add https://api.mapbox.com and https://events.mapbox.com to connect-src in TALISMAN_CONFIG
- 02Reload and check the browser console for blocked requests
Did this fix it?FIX 3Use OpenStreetMap tiles
- 01Configure DECKGL_BASE_MAP in superset_config.py with an OSM tile layer
- 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 usThe same problem in other apps
All missing or lost data guides →
Metabase Filter Dropdown Not Showing Values (Metabase)
Looker Studio Can't Save This Report Right Now (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 Embedded Dashboard Not Loading (403 or Refused to Connect)
- Superset Could Not Load Database Driver
- Superset CSV Upload Option Missing
- Superset Forgot Admin Password (How to Reset Login)