Custom fields let you attach extra data to your locations beyond the standard fields like phone, email, and website. Think store numbers, manager names, product lines, or certifications.
Once you create a field and populate it, it shows up automatically on your widget's location cards.
Creating custom fields
Go to your Fields page
Click Create Field
Give it a name (this is what visitors will see on the widget, so keep it clear)
Choose a field type: Text for short values, Textarea for longer descriptions
Hit Save
Your field now exists, but it won't show up on the widget until you actually fill it in for at least one location.
Adding data to locations
In the dashboard
Go to Locations, edit a location, and scroll to the Custom Fields section. Fill in the values and save. Works great for a few locations, but importing is faster at scale.
Via CSV or Google Sheets
Add a column to your spreadsheet with this exact format:
Field: Your Field Name
The column header must start with Field: followed by a space, then the exact field name as it appears in StoreRocket.
Here's an example CSV:
name, address, Field: Store Number, Field: Certifications Downtown Store, 123 Main St, S001, "Organic, Fair Trade" Airport Location, 456 Terminal Blvd, S002, Organic Suburban Store, 789 Oak Ave, S003, ""
Key details:
The
Field:prefix and field name must match exactly (case-sensitive)If a field doesn't exist yet, StoreRocket creates it automatically during import
Leave the cell empty if a location doesn't have a value for that field
Works the same way for both CSV import and Google Sheets sync
Import your file at the Import page.
How fields display on the widget
Custom fields show in two places on the widget:
On the location card in the results list (next to the store's name, address, phone, etc.)
In the map popup / info window when a visitor clicks a map marker
In both places, each field renders as "Field Name: Value". Empty fields are hidden automatically, so no blank labels clutter the widget — if a specific location doesn't have a value for a field, that field just won't appear on that location's card or popup.
Controlling whether custom fields show at all
You can toggle custom fields on or off for the whole widget:
Go to Store Locator Map → Components
Find the Custom Fields toggle
Turn it off to hide ALL custom fields on every location card and popup, or turn it on to show them
This is an all-or-nothing toggle — there's no way to show some custom fields and hide others at the project level. If you want a field to only appear on some locations, leave the field blank on the locations where you don't want it.
Order of custom fields
Custom fields display in the order you created them (by internal ID). There's no drag-to-reorder control today. If field order matters to you, create your fields in the order you want them shown, or delete and re-create to change the order.
Editing and deleting fields
Rename or delete fields from your Fields page. Deleting a field removes it and all its data from every location. There's no undo.
Custom fields vs search filters
This trips people up sometimes:
Custom Fields | Search Filters | |
Purpose | Display information | Let visitors filter/search |
Visitor interaction | Read-only | Clickable, selectable |
Example | "Store Number: S001" | "Drive-Through" checkbox |
If you want visitors to be able to search or filter by a value, use a search filter instead. Custom fields are for displaying information only.
Troubleshooting
Field not showing on the widget
A few things to check, in order:
Empty value? The most common reason. If the field is blank for a specific location, it won't render on that location's card or popup. Go to Locations, edit the location, scroll to Custom Fields, and fill in the value.
Custom Fields toggle off? Go to Store Locator Map → Components and make sure the Custom Fields toggle is on. If it's off, no custom fields will display anywhere.
Widget cache? After editing, hard refresh your website (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac).
Can I control where a specific field appears or reorder them?
Not today. Fields render in creation order, and the position within the card/popup is fixed by the widget template. If you need a field at a specific spot, create your fields in the order you want them shown.
Import not picking up my fields
Check your CSV column header. It must be exactly Field: Name with a capital F, a colon, and a space. The field name must match your StoreRocket field name exactly (case-sensitive). "Store Number" and "Store number" are treated as two different fields.
Questions? Hit us up on live chat.