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

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

  1. FIX 1Match the geo key

    1. 01Compare the Geo region key column in your Regions sheet with the Regions geometry tab
    2. 02Use ISO or area codes instead of names where possible
    Did this fix it?
  2. FIX 2Merge your data

    1. 01Download the Regions geometry sheet as GeoJSON
    2. 02Use Upload & merge on the Regions tab, joining on the Geo region key
    3. 03Check the Preview tab
    Did this fix it?
  3. FIX 3Style missing regions

    1. 01Go to Regions layer > Missing values to set how unmatched regions look
    Did this fix it?
  4. FIX 4Convert and reproject boundaries

    1. 01Open your file in mapshaper.org
    2. 02Reproject to WGS84 and export as GeoJSON
    3. 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 us

Watch Flourish 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 missing or lost data guides →

Other Flourish errors

All 10 Flourish errors and fixes →