How to add your own map regions

Flourish offers a selection of different blueprints to start with. But if the country or region you'd like to display isn't one of them, you can add it yourself.

TIP: Struggling to find the right regions for your map? Check out our GeoJSON repository where we've sourced, checked, and resized various region files ready for you to download and use in Flourish.

    In the template chooser, select the Projection map (Blank) starting point.

    To add your own regions to a Flourish map, you will have to upload them in a GeoJSON format. The file should contain a FeatureCollection with each feature being a Polygon or MultiPolygon in unprojected (WGS84) coordinates. 
    You need to upload your GeoJSON in the Region geometry tab by dragging it to the editor or selecting to import it.

    TIP: We recommend GeoJSON file sizes up to 5 MB. Anything larger than that will reduce performance. To learn how to resize your GeoJSON file, head over to this help doc.

    WARNING: If you upload your own GeoJSON and your map doesn't seem to display, the coordinates in your GeoJSON are probably not WGS84. To transform your coordinates to be WGS84, you can use the free online tool

    Bind your geometry column under GeoJSON geometry setting in the Data tab.
    In the Preview tab, choose Projection > Bounds > Auto to make sure that your coordinates display properly. You may also have to refresh the page.

    TIP: Read more about different map projections in this help doc.

    WARNING: We currently only support polygons with at least 4 points. If you add a polygon with less than 4 points, it will not render on your map.

    If your regions display in the editor, then your upload has been successful.

    To connect the shapefiles to the rest of the data you'd like to visualize, you need to select a column that would serve as the connection between the Regions and Regions geometry tabs. That could be ISO codes, constituency names, or any other unique IDs. Bind it under the Geo region key setting.

    You can now upload your values, labels and other metadata under the Regions tab, as you would normally do. Make sure that your dataset contains the same Geo region key column as the one you use as an anchor from the Regions geometry tab.