// troubleshooting guide · flourish
Flourish Map Regions Not Showing or Not Matching
- Status
- Workaround available
- platforms:
- Web
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · flourish/map-regions-not-matching4 FIXES
// quick answer
Region colors only appear when your geo key matches the boundary file exactly. Use codes (ISO, area codes) instead of names, and reproject custom boundaries to WGS84.
Most likely fix: Match the geo key
How to fix it
// try these in order, the most common fix is first
FIX 1Match the geo key
- 01Compare the Geo region key column in your Regions sheet with the Regions geometry tab
- 02Use ISO or area codes instead of names where possible
Did this fix it?FIX 2Merge your data
- 01Download the Regions geometry sheet as GeoJSON
- 02Use Upload & merge on the Regions tab, joining on the Geo region key
- 03Check the Preview tab
Did this fix it?FIX 3Style missing regions
- 01Go to Regions layer > Missing values to set how unmatched regions look
Did this fix it?FIX 4Convert and reproject boundaries
- 01Open your file in mapshaper.org
- 02Reproject to WGS84 and export as GeoJSON
- 03Upload it again; small region icons should appear in the Geometry column
Did this fix it?
SANDBOX · flourish RUNS IN YOUR BROWSER
Try it: design and hand off a screen
A hands-on Flourish-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Some or all map regions are grey/blank, or your uploaded boundaries don't appear.
Why it happens
- C-01Region names spelled differently in your data and the boundary file
- C-02Your data covers only some regions in the geometry file
- C-03Uploaded boundaries aren't in WGS84 coordinates
- C-04Boundary file is a shapefile or TopoJSON instead of GeoJSON
// this guide also covers
- flourish map regions missing
- flourish projection map not showing
- flourish custom map upload
Still not working?
If Flourish keeps failing, you're not alone. See every Flourish 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 Flourish errors
- Flourish Embed Cut Off or Wrong Height
- Flourish Chart Not Showing When Embedded
- Flourish Embed Not Showing Latest Changes
- Flourish Google Sheets Data Not Updating
- How to Remove "Made with Flourish" From Embeds
- Flourish Download Video Not Available or Failing
- Flourish Not Recognizing Numbers or Dates
- Flourish App in Canva Asking to Upgrade