Importing DataUpdated 2026-08-25
Import stores from a CSV file
What this article helps you do
Upload a CSV file to import store locations into Mapstore. Use this method for one import or for infrequent updates.
Before you start
- You have a CSV file with store data.
- Each row has the required name and address columns.
- Optional columns include phone, email, website, description, and filters. See Prepare a CSV file.
Step-by-step instructions
1. Go to Stores -> Bulk
- In Mapstore, go to Stores.
- Open Bulk.
The CSV upload section has File and URL options.
2. Select File mode
Select Upload a CSV file (or File) as the import method.
3. Prepare and upload
- Make sure that the CSV has a header row with
nameandaddress. - Drag and drop your CSV file into the drop zone, or click to select it.
- If you want to replace previously CSV-imported stores with this CSV, check Delete existing stores uploaded through CSV.
- Click Test CSV to preview the import without a change to store data.
- Review the planned changes and skipped rows.
- If necessary, fix the file.
- Test the file again.
- Click Upload.
4. Start a replacement import
If you checked Delete existing stores uploaded through CSV, Mapstore shows a confirmation message. Continue with the import.
5. Wait for processing
- Mapstore immediately processes files with 1,000 rows or fewer and shows a success message.
- Mapstore processes larger files in the background.
- Mapstore sends an email only when it skips rows or the import fails.
How to verify it worked
- Go to Stores.
- Make sure that you can see your locations.
- If Mapstore skipped rows, use the row numbers and causes in the import summary.
- Open the store locator on the storefront.
- Make sure that you can see the stores on the map.
Troubleshooting
| Issue | Fix |
|---|---|
| Rows skipped | Each row must have name and address. See Fix skipped CSV rows. |
| Incorrect file type | Use a CSV file (.csv or text/csv). Do not use an Excel file (.xlsx). |
| Large file takes time | Mapstore processes files over 1,000 rows in the background. Check Stores for results. Mapstore sends email only for skipped rows or failures. |