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

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

  1. FIX 1Simplify and reproject in Mapshaper

    1. 01Open the file in mapshaper.org
    2. 02Run -proj wgs84 in the console
    3. 03Simplify until the export is under 2 MB (under 500 KB loads faster)
    4. 04Export as TopoJSON and upload again
    Did this fix it?
  2. FIX 2Use TopoJSON for API uploads

    1. 01Convert the GeoJSON to TopoJSON in Mapshaper before sending it through the API
    Did this fix it?
  3. FIX 3Locator maps: overlay borders instead

    1. 01Turn off the default country borders
    2. 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 us

Watch Datawrapper 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 Datawrapper errors

All 12 Datawrapper errors and fixes →