MigrationUpdated 2026-08-25

Move stores to Mapstore

What this article helps you do

Move your locations from a different store-locator app to Mapstore. Use this procedure to export, prepare, and import the data.

Before you start

  • You can export a CSV or spreadsheet from your current store locator.
  • Mapstore is installed.
  • You can access Stores in the admin.
  • You know the fields that your current app uses, such as name, address, and phone.

Step-by-step instructions

1. Export your data from the previous app

Use the export feature in your current store locator to download a CSV or spreadsheet. Keep the source file as a backup.

2. Map your columns to Mapstore format

Each store must have name and address. Your previous app can use different column names. Mapstore accepts store_name or location_name for name. It accepts full_address or location for address. See Map source fields to Mapstore CSV columns.

3. Prepare and validate your CSV

  • Make sure that each row has name and address.
  • Remove or fix empty rows.
  • Save the file as CSV. Use Prepare a CSV file for format details.

4. Preview the import

  1. In Stores -> Bulk, select your file.
  2. Click Test CSV.
  3. Review the skipped rows, planned changes, geocoding, and plan limit.
  4. To replace an earlier CSV import, select Delete existing stores uploaded through CSV before the test.

The preview does not change store data. It includes the planned deletions when you select the replacement option.

5. Replace CSV-imported stores when ready

When you want Mapstore to match the CSV with no differences, use Delete existing stores uploaded through CSV. Mapstore deletes only prior CSV-imported rows and imports your new file.

6. Verify on the storefront

  1. Open the store-locator page.
  2. Make sure that you can see the locations on the map and in the list.

How to verify it worked

  1. Make sure that you can see all necessary stores in Stores.
  2. Make sure that the import summary has no unexpected skipped rows.
  3. Make sure that the store-locator map shows your locations.
  4. Make sure that you can see the phone and email information in the correct positions.

Troubleshooting

Issue Fix
Many rows skipped Check that the file has name and address columns and that each row has values. See Fix skipped CSV rows.
Column names not recognized Rename headers to standard names or known aliases. See Match CSV columns.
Geocoding failures during import Add lat and lng in your CSV if available. You can also test a Google Maps API key before the import. See Fix stores without map coordinates.
Manual stores disappeared Replacement targets only CSV-imported stores. Check the source type. If necessary, import the backup CSV.