The CSV (comma-separated values) format is common for table data, like the kind you would use in Excel or other spreadsheet programs. CSV files are not mappable unless they contain geographic information including latitude and longitude. You can upload CSVs to Mapbox using Mapbox Studio or the Uploads API.

When you upload CSV files, follow these guidelines:

  • CSV files must contain coordinates (latitude and longitude) to be uploaded to Mapbox Studio.
  • CSV files are for point data only.
  • CSV files must be in UTF-8 encoding.
  • Data imported via CSV will be encoded as a string type in the Mapbox Studio dataset editor. If you want to code any of your imported data as numbers, you can edit the fields individually in the dataset editor or upload your data in GeoJSON format.

Related resources:

Download a sample CSV file