// troubleshooting guide · datawrapper
Datawrapper Map Regions Not Matching Data
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
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
FIX 1Fix unmatched rows
- 01Open the Check tab and click a highlighted entry
- 02Unmatched rows show in red; pick the right key from the dropdown
Did this fix it?FIX 2Match on IDs instead of names
- 01In the Match tab choose the column with IDs and the matching key type
- 02Download the CSV of accepted keys from the Match tab to compare
Did this fix it?FIX 3Use the right map for ZIP codes
- 01For US Census data use a ZCTA map instead of a ZIP code map
Did this fix it?FIX 4Fix symbol positions and labels
- 01Add more detail to place names (city, state, country) or use latitude and longitude columns
- 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 usOther 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 Custom Map Upload Not Working
- Datawrapper Locator Map Not Exporting
- Datawrapper Export PDF or SVG Not Available
- Datawrapper Embed Shows 404 Not Found