Import stores from a CSV file

What this article helps you do

Import store locations from a CSV file by uploading it in Mapstore. Suitable for one-time imports or occasional updates.

Before you start

• You have a CSV file with store data
• Required columns: name and address (every row must have both)
• Optional columns: phone, email, website, description, filters, etc. (see Preparing a CSV file for store import)

Step-by-step instructions

1. Go to Stores -> Bulk

In Mapstore, go to Stores and open Bulk. You’ll see the CSV upload section with a choice between File and URL.

2. Choose File mode

Select Upload a CSV file (or File) as the import method.

3. Prepare and upload

1. Ensure your CSV has a header row with column names and includes name and address.
2. Drag and drop your CSV file into the drop zone, or click to select it.
3. If you want to replace previously CSV-imported stores with this CSV, check Delete existing stores uploaded through CSV.
4. Click Upload.

4. Confirm if replacing stores

If you checked Delete existing stores uploaded through CSV, a confirmation modal appears. Confirm to replace prior CSV-imported stores with this file.

5. Wait for processing

• For files with up to 1,000 rows, processing happens immediately and you’ll see a success toast.
• For larger files, the import runs in the background.
• You receive an email only if rows were skipped or the import failed.

How to verify it worked

1. Go to Stores and check that your locations appear.
2. If any rows were skipped, the import summary shows row numbers and reasons (e.g. missing name or address).
3. View your store locator on the storefront to confirm stores show on the map.

Common issues and fixes

Related articles

• Preparing a CSV file for store import
• Import stores from a CSV URL
• Replace existing CSV-imported stores safely
• Understand skipped rows and import warnings