Overview
The Import feature allows you to efficiently add or edit large numbers of locations on your Mapme interactive map. It’s especially useful when working with 20+ locations or performing bulk updates.
With Import, you can:
- Add many locations at once
- Update and reorder existing Locations
🎥 Watch our video tutorial to learn how to use Import step-by-step.
Two Import Methods
Mapme offers two ways to import data:
- Standard Import using Mapme Template
Use our structured template to prepare your data with required fields. - AI Import (Map AI Import)
No need to follow Mapme’s format—just upload your data and let Map AI map your content.
👉 Learn more about Map AI Import
Import Flow
- Upload your Excel or CSV file
- Review and refine the data
- Choose import mode: Add or Sync
- Complete the import
How to Import with the Mapme Template
1. Generate a Template
We recommend generating your template based on your current map setup:
- Add a few locations manually in the editor
- Go to the Import & Export tab and click Export to download the template
Alternatively, use one of our ready-made templates:
- 📥 Download Excel version
- 📋 Copy Google Sheet version (Recommended – includes media & table generator)
2. Add Your Data
Fill in your location data using the template.
🔹 The order of locations and categories in the file will define their order on the map.
🔹 Save your file as Excel (.xlsx) or CSV (UTF-8).
Important:
- Do not rename the column headers in the template.
- For Excel files, your data must be on the first sheet.
3. Upload Your File
- Click on the import area or drag your file into the uploader.
4. Review Your Data
After upload, you’ll see your data displayed in a preview table.
Make sure:
- All fields are correctly matched
- Data appears under the correct column
5. Select Import Mode
Choose one of the following:
- Add – Adds new locations without affecting existing ones.
- Sync – Replaces all current locations with the new file (⚠️ irreversible).
6. Finalize the Import
Click Import to complete the process.
⏱ Importing may take up to 2 minutes depending on file size and media content.
Supported Import Fields
Your import file should include specific fields to match your map configuration. See the full list of supported fields
| Fields | Type | Description | Format | Range | Note |
| mapmeId | optional | Id | This field is used ONLY used when updating existing locations. It is generated with the data Export. |
||
| name | required | The name of the location | text up to 128 characters | ||
| description | optional | The description of the location | text up to 8192 characters | Can include HTML. We recommend no more than 1000 chars | |
| categories | optional | The category assigned to the location | text up to 128 characters per category | To select multiple categories, separate with “;” sign as in: category1;category2;category3 |
|
| address | optional | The address of the location | text up to 256 characters | You can either enter the address or the lat/long. If you enter both the lat/long will be used to place the marker |
|
| latitude | optional | The longitude of the location | number | -90 to 90 | |
| longitude | optional | The latitude of the location | number | -180 to 180 | |
| pitch | optional | The 3D effect of the location view | number | 0 to 85 | 0: the map is flat 85: the map is set at a 85-degree angle |
| zoom | optional | The zoom of the location view | number | 2 to 22 | 2: the map shows the entire world 22: the map is fully zoomed in 3D buildings are displayed at 15 and above |
| bearing | optional | The angle of the location view | number | 0 to 360 | |
| actionText | optional | The action button text | text up to 128 characters | Example: Book now | |
| actionUrl | optional | The action button URL | URL up to 1024 characters | Example: https://mywebsite.com Need to start with https:// |
|
| media | optional | The media list | string | Example: image;url\https://mywebsite.com/images/myimage1.png |
Update, Delete, or Sort Locations
🎥 Watch our Advanced Import Video tutorial to learn how to Edit or Add locations.
You can use Export + Import to:
- Edit data in bulk
- Delete multiple locations
- Change the display order of locations
Updating Locations
- Export your map data
- Edit your CSV/Excel file in Excel or Google Sheets
- Don’t delete or change the
mapmeIdfield—it’s used to match existing locations - Save as Excel or CSV (UTF-8)
- Re-import the file
Deleting Locations
- Export your map data
- Delete the rows of the locations you want to remove
- Save as Excel or CSV (UTF-8)
- Re-import the file
(Only deleted rows will be removed from your map)
Sorting Locations
- Export your map data
- Reorder rows in your file as needed
- Don’t delete or change the
mapmeIdfield—it’s used to match existing locations - Save as Excel or CSV (UTF-8)
- Re-import the file
Importing Media
You can add media during import to save time. Supported media types include:
- Images
- YouTube and Vimeo links
- Uploaded videos
- PDFs
- Embeds (e.g., Matterport tours, Notion pages)
Exporting Your Map Data
Use the Export feature to download all your map locations in CSV format. It includes:
- Published locations
- Draft locations
🚫 Deleted locations (even if not published yet) are not included in the export.
To export:
- Go to the Import & Export tab
- Click Export