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 Google Sheets.

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​