// troubleshooting guide · datawrapper

Datawrapper Map Regions Not Matching Data

Status
Workaround available
platforms:
Web
updated:
November 16, 2026
reports:
2
Method
how we research
Share

RUNBOOK · datawrapper/map-regions-not-matching4 FIXES

// quick answer

Region names or IDs in your data don't match the basemap's keys. Fix the red rows in the Check tab or match on an ID column (like ISO codes) in the Match tab.

Most likely fix: Fix unmatched rows

How to fix it

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

  1. FIX 1Fix unmatched rows

    1. 01Open the Check tab and click a highlighted entry
    2. 02Unmatched rows show in red; pick the right key from the dropdown
    Did this fix it?
  2. FIX 2Match on IDs instead of names

    1. 01In the Match tab choose the column with IDs and the matching key type
    2. 02Download the CSV of accepted keys from the Match tab to compare
    Did this fix it?
  3. FIX 3Use the right map for ZIP codes

    1. 01For US Census data use a ZCTA map instead of a ZIP code map
    Did this fix it?
  4. FIX 4Fix symbol positions and labels

    1. 01Add more detail to place names (city, state, country) or use latitude and longitude columns
    2. 02Turn off Prevent label overlapping to show every label
    Did this fix it?

Symptoms

Some regions on a choropleth map stay grey, ZIP code areas don't line up, symbol map points land in the wrong place, or some map labels are missing.

Why it happens

  • C-01Different spellings ("Czechia" vs "Czech Republic"), abbreviations or extra spaces
  • C-02Matching on names instead of IDs
  • C-03ZIP code basemaps are approximate areas, not official boundaries
  • C-04Ambiguous place names: Datawrapper uses the first geocoding result
  • C-05Labels hidden by the Prevent label overlapping setting

// this guide also covers

  • datawrapper map not matching
  • datawrapper choropleth regions grey
  • datawrapper zip codes don't match
  • datawrapper map labels not showing

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

Other Datawrapper errors

All 12 Datawrapper errors and fixes →