Mapme Import Guide

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:

  1. Standard Import using Mapme Template
    Use our structured template to prepare your data with required fields.
  2. 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

  1. Upload your Excel or CSV file
  2. Review and refine the data
  3. Choose import mode: Add or Sync
  4. 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:

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

  1. Export your map data
  2. Edit your CSV/Excel file in Excel or Google Sheets
  3. Don’t delete or change the mapmeId field—it’s used to match existing locations
  4. Save as Excel or CSV (UTF-8)
  5. Re-import the file

Deleting Locations

  1. Export your map data
  2. Delete the rows of the locations you want to remove
  3. Save as Excel or CSV (UTF-8)
  4. Re-import the file
    (Only deleted rows will be removed from your map)

Sorting Locations

  1. Export your map data
  2. Reorder rows in your file as needed
  3. Don’t delete or change the mapmeId field—it’s used to match existing locations
  4. Save as Excel or CSV (UTF-8)
  5. Re-import the file

👉 More on sorting locations into categories

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)

👉 Learn more about media import

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:

  1. Go to the Import & Export tab
  2. Click Export

Related Articles

Contact Us

Questions. Need help? Use the chat button or the Contact Us form

I Getting Started

Check our 2 mins Getting Started Tutorial video

New Features

Check the release notes for the latest features and improvements