You've got a spreadsheet full of locations and you want them in StoreRocket. Good news: this only takes a few minutes. You can either upload a CSV file directly or connect a Google Sheets spreadsheet for ongoing sync.
Two ways to import
CSV file upload is the fastest option. You upload a file, StoreRocket processes it, and you're done. Best for one-time imports or when you're setting up your account for the first time.
Google Sheets sync connects a live spreadsheet to your project. You can sync locations back and forth whenever you want, and even enable daily auto-sync. Best for teams that manage locations in spreadsheets and want changes to flow into StoreRocket automatically.
Both methods use the same column format, so everything you learn here applies to both.
CSV column reference
Here's every column StoreRocket recognizes. You don't need to use all of them. At minimum, you need Name and an address (either split into parts or as a full address).
Required columns
Column | Description | Example |
Name | The location name |
|
Address Line 1 | Street address |
|
You can use individual address fields OR a single Full Address column. Don't use both.
Address fields
Column | Description | Example |
Address Line 1 | Street address |
|
Address Line 2 | Suite, floor, unit |
|
City | City name |
|
State | State or province |
|
Postcode | Zip or postal code |
|
Country | Country code or name |
|
Or use a single column instead:
Column | Description | Example |
Full Address | Complete address in one column |
|
If you provide individual address fields, StoreRocket combines them into a full address automatically. If you use Full Address, it gets geocoded as-is.
Contact and info columns
Column | Description | Example |
Phone | Phone number |
|
Email address | ||
URL | Website link | |
Facebook page URL | ||
Instagram profile URL | ||
X / Twitter | X (Twitter) profile URL |
Display and visibility
Column | Description | Example |
Visible | Show on widget? |
|
Type | Location type name |
|
Slug | Custom URL slug |
|
Image | Cover image URL |
If you leave Visible empty, the location defaults to visible.
Coordinates
Column | Description | Example |
Lat | Latitude |
|
Lng | Longitude |
|
Don't worry about these. If you leave them blank, StoreRocket geocodes the address automatically and fills in the coordinates for you. Only include them if you already have precise coordinates and want to skip geocoding.
Opening hours
Hours use 24-hour format only. No AM/PM. Add one column per day of the week.
Column | Format | Example |
Monday |
|
|
Tuesday |
|
|
Wednesday |
|
|
Thursday |
|
|
Friday |
|
|
Saturday |
|
|
Sunday |
|
|
For a location that's open 24 hours, use 00:00-23:59. For closed days, write Closed or leave the cell empty.
Alternative: hours templates. If you've already created reusable hours templates in Hours, you can reference them by name using the Hours ID column instead of specifying each day:
Name, Address Line 1, Hours ID Store 1, 123 Main St, Standard Hours Store 2, 456 Oak Ave, Weekend Only
The template must already exist in your project before importing.
Filters (search categories)
This is the column that trips people up the most, so pay attention.
Filters go in a single column called Filters. For each location, list the filter names separated by commas.
Name, Address Line 1, Filters Store 1, 123 Main St, "WiFi, Parking, Pet Friendly" Store 2, 456 Oak Ave, "Pet Friendly, Open 24h" Store 3, 789 Pine Dr, WiFi
How it works:
The column must be named exactly
Filters(notFilter, notTags, notCategories)List multiple filters separated by commas inside the cell
Wrap the cell in quotes if it contains commas (most spreadsheet apps do this automatically when exporting to CSV)
Filter names are matched by text, not case-sensitive, so "WiFi" and "wifi" are treated the same
If a filter doesn't exist in your project yet, StoreRocket creates it automatically
Common mistakes:
Naming the column
Filter(singular) instead ofFiltersCreating separate columns per filter (like
WiFi,Parkingas column names). That won't work. Use oneFilterscolumn with comma-separated valuesPutting
yes/novalues. Just list the filter names that apply to each location. If a filter doesn't apply, don't include it
Custom fields
Custom fields let you store extra data on each location (store number, manager name, product lines, anything). The column header uses the Field: prefix.
Column header | Cell value |
|
|
|
|
|
|
Add a separate column for each custom field. If the field doesn't exist in your project yet, StoreRocket creates it automatically during import.
The column header format must be exact: Field: followed by a space and the field name.
Call-to-action buttons
You can add CTA buttons (like "Order Now" or "Book Appointment") using the Button: prefix. The cell value is the URL the button links to.
Column header | Cell value |
| |
|
Add a separate column for each button. If the button doesn't exist in your project yet, StoreRocket creates it automatically. Leave the cell empty for locations that don't need a particular button.
Other columns
Column | Description |
Timezone | IANA timezone string (e.g. |
Marker ID | Internal marker ID. Only needed if assigning custom markers by ID |
Yelp | Yelp business ID |
StoreRocket ID | Used for updating existing locations during re-import |
How to import a CSV file
Step 1: Download the template
Go to the Import page and click Download the template. This gives you a pre-formatted file with all the column headers in the right order.
Open it in Excel, Google Sheets, or Numbers and fill in your location data.
Step 2: Save as CSV
When your data is ready, save the file as CSV. In most spreadsheet apps, go to File > Save As (or Download as) and pick Comma Separated Values (.csv).
Don't delete any columns from the template, even if you're not using them. Leave unused columns blank. Removing default columns can cause the import to break.
Step 3: Upload and import
Go to the Import page
Upload your CSV file
Review the "Delete all previous locations" toggle (more on this below)
Click Upload file
Wait for the import to finish
Step 4: Check your locations
Head to your Locations list and verify everything looks right. Then check your Widget preview to see them on the map.
Locations without coordinates will be geocoded in the background. This can take a few minutes depending on how many new addresses need processing.
About "Delete all previous locations"
There's a toggle on the import page that says Delete ALL the previous locations before the import. This does exactly what it sounds like. It wipes every existing location in your project before importing the new file.
Only turn this on if you're intentionally replacing your entire dataset. If you just want to add new locations alongside existing ones, leave it off.
If you accidentally check this box and import, your old locations are gone. The fastest way to recover is to re-sync from Google Sheets (if you have it connected) or re-import a backup CSV.
Google Sheets sync
Google Sheets sync creates a live connection between a Google spreadsheet and your StoreRocket project. You can push locations to the sheet, pull locations from the sheet, or set up daily auto-sync.
Setting up Google Sheets
Go to Google Sheets Setup
Click to create a new linked spreadsheet
StoreRocket creates a Google Sheet with all the right column headers pre-filled
The spreadsheet is created in StoreRocket's Google Drive and shared with you. You can also share it with team members from the setup page.
Sync directions
Sync to Sheets (export): Pushes your current StoreRocket locations into the spreadsheet. Go to Sync page and click the sync-to option. This overwrites whatever is in the sheet with your current StoreRocket data.
Sync from Sheets (import): Pulls locations from the spreadsheet into StoreRocket. Go to Sync page and click the sync-from option. This updates your StoreRocket locations to match the spreadsheet.
Auto-sync
You can enable daily auto-sync from the Setup page. When enabled, StoreRocket automatically syncs from your spreadsheet once a day. This is great if your team regularly updates the spreadsheet and you want changes to flow in without manual intervention.
Tips for Google Sheets
The column format is identical to CSV. Everything in the column reference section above applies here too
Don't edit the spreadsheet while a sync is running. Wait for it to finish first
Don't rename, reorder, or delete the header columns. StoreRocket needs them in the expected format
Sync processes about 1,500 locations per minute. Large datasets might take a few minutes
After syncing, new addresses without coordinates are geocoded in the background
Exporting locations
You can download all your locations as a CSV file at any time.
Go to your Locations page
Click the Export button
Your browser downloads a CSV with all your location data
This is useful as a backup before a big import, or if you want to make bulk edits in a spreadsheet and re-import.
Troubleshooting
Import stuck or spinning
Wrong file format: The import accepts
.csv,.txt,.xls, and.xlsxfiles. If you're uploading something else, it won't workFile too large: The maximum file size is 10MB. If your file is larger, try splitting it into smaller batches
Encoding issues: Save your CSV as UTF-8. Some spreadsheet apps default to other encodings which can cause problems with special characters
Extra whitespace or hidden characters: If you copied data from a website or PDF, there might be invisible characters in your cells. Try pasting into a plain text editor first, then into your spreadsheet
Locations imported but not showing on the map
Missing address: Every location needs either Address Line 1 or Full Address. Without an address, there's nothing to geocode and no way to place it on the map
Geocoding still running: After import, StoreRocket geocodes new addresses in the background. Give it a few minutes, then refresh
Visible column set to 0: Check if the Visible column is set to
0for those locations. That hides them from the widget. Edit the locations or re-import with1in the Visible columnCountry missing or wrong: If your addresses don't include a country, the geocoder might place them in the wrong location or fail entirely. Adding a Country column helps a lot
Filters not importing
This is the most common import issue. Nine times out of ten, it's a column naming problem.
The column must be named exactly
Filters(plural, capital F)Filter,filters,Tags,Categorieswon't be recognizedFilter values go in a single column, separated by commas:
WiFi, Parking, Pet FriendlyDon't create separate columns per filter. One column, comma-separated names
If a filter name has a comma in it (rare, but it happens), the import will split it into two separate filters
Hours showing incorrectly
Must be 24-hour format: Use
09:00-17:00, not9am-5pmor9:00 AM - 5:00 PMExcel auto-formatting: Excel loves to "helpfully" reformat time values. Set the column format to Text before entering hours to prevent this
Separator: Use a hyphen between open and close times:
09:00-17:00
Custom fields not appearing
The column header must start with
Field:followed by a space and the exact field nameExample:
Field: Store Number(not justStore Number)Fields are auto-created if they don't exist yet, so this is usually a formatting issue with the column header
Buttons not saving
The column header must start with
Button:followed by a space and the button nameExample:
Button: Order Now(not justOrder Now)The cell value must be a complete URL including
https://If a location doesn't need a button, leave the cell empty
Accidentally deleted all locations
If you checked "Delete all previous locations" by mistake:
If you have Google Sheets connected: Sync from Sheets to restore your locations
If you have a recent CSV export: Re-import that file
If neither: Reach out on live chat immediately and we'll help recover your data
Quick reference: column name cheat sheet
What you want | Column name | Value format |
Location name |
| Text |
Street address |
| Text |
Full address |
| Complete address string |
Filters/categories |
| Comma-separated names |
Custom field |
| Text |
CTA button |
| URL |
Day hours |
|
|
Hours template |
| Template name |
Location type |
| Type name |
Visibility |
|
|
Cover image |
| Image URL |
Coordinates |
| Decimal numbers |
Need help with your import? Hit us up on live chat and we'll sort it out.