Skip to main content

Regions import from CSV

Use the CSV import flow when your map uses region-linked data or when region IDs in your spreadsheet should attach objects to SVG regions (for example US-TX, US-AL on a calibrated map).

The same Database → CSV import tools apply: you can upload a file or use a remote CSV URL / published Google Sheet. For remote URLs, automatic re-fetch and large-file behavior work the same as for database objects—see CSV import (database) and the overview Google Sheets auto-sync with maps.

Regions column in CSV

Region associations must use region IDs exactly as defined on your SVG (comma-separated for multiple regions):

ExampleValid?
US-TXSingle region ID.
US-TX,US-AL,US-NYMultiple IDs — commas between values.
US-TX US-AL US-NYInvalid — spaces are not a separator; use commas.

Use IDs from your map file (e.g. calibrated country/state maps), not display titles like Texas unless that matches your region ID scheme.

Headers and sync

  • The first row must contain field names that match your schema exactly—same names as in Database → Edit fields.
  • Click Sync fields next to the upload or URL field so MapSVG reads headers and can suggest fields that are still missing from the schema.

Shared formatting rules

The full CSV field format reference (Select, Checkbox, Location, Post, Date, Image, etc.) is identical to database CSV import. Use the same table:

CSV field format reference

Example spreadsheets