// troubleshooting guide · datawrapper
Datawrapper Custom Map Upload Not Working
- Status
- Workaround available
- platforms:
- Web, API
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · datawrapper/custom-map-upload-error3 FIXES
// quick answer
Uploaded maps must be valid TopoJSON or GeoJSON in WGS-84 and under 2 MB. Simplify and reproject the file in Mapshaper, and use TopoJSON for API uploads.
Most likely fix: Simplify and reproject in Mapshaper
How to fix it
// try these in order, the most common fix is first
FIX 1Simplify and reproject in Mapshaper
- 01Open the file in mapshaper.org
- 02Run -proj wgs84 in the console
- 03Simplify until the export is under 2 MB (under 500 KB loads faster)
- 04Export as TopoJSON and upload again
Did this fix it?FIX 2Use TopoJSON for API uploads
- 01Convert the GeoJSON to TopoJSON in Mapshaper before sending it through the API
Did this fix it?FIX 3Locator maps: overlay borders instead
- 01Turn off the default country borders
- 02Import your borders as area/line markers from a GeoJSON file
Did this fix it?
Symptoms
Uploading your own basemap fails, the map is empty or distorted, or the API rejects the file.
Why it happens
- C-01File over 2 MB
- C-02Wrong coordinate system (not WGS-84)
- C-03Invalid JSON
- C-04GeoJSON uploaded via the API (only TopoJSON works there)
- C-05Trying to use a custom basemap on a locator map
// this guide also covers
- datawrapper upload own map
- datawrapper geojson not working
- datawrapper topojson upload
- datawrapper custom basemap
Still not working?
If Datawrapper keeps failing, you're not alone. See every Datawrapper problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Other Datawrapper errors
- Datawrapper Embedded Chart Cut Off or Too Much Space
- Datawrapper Google Sheets Chart Not Updating
- Datawrapper Embed Not Showing Latest Changes
- Datawrapper Not Recognizing Numbers or Dates
- Datawrapper Map Regions Not Matching Data
- Datawrapper Locator Map Not Exporting
- Datawrapper Export PDF or SVG Not Available
- Datawrapper Embed Shows 404 Not Found