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 fill it in, it shows on your widget when a visitor opens a location. You can also show it on the location cards in the results list.
Creating custom fields
Go to Custom Fields
Select New custom field
Type a Field name. This is what visitors will see beside the value, so keep it clear
Choose a Field type: Text for short values, Multiline for longer descriptions, or Phone, Link, Email, Yes / No or Number when the value is one of those
Select Create field
Your field now exists, but it won't show up on the widget until you actually fill it in for at least one location.
A field name can be up to 60 characters. You can't create two fields with the same name, and capital letters don't make a name different. "Store Number" and "Store number" are the same field.
Adding data to locations
In the dashboard
Go to Locations, open a location, and find Custom fields in the Enrich 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 field name. 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:
A column is only read as a custom field when its header starts with
Field:. StoreRocket recognizes these columns on its ownCapital letters in the field name don't matter. If a field doesn't exist yet, StoreRocket creates it automatically during import, with a capital letter on each word
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 Location Data > Import.
How fields display on the widget
Custom fields can show in two places on the widget:
On the location card in the results list, next to the store's name, address, phone, etc. This is off until you turn it on
When a location is open, in its details panel and in the map popup. This is on until you turn it off
In both places each field shows its name next to its 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, details or popup.
Controlling whether custom fields show at all
You can switch custom fields on or off for the whole widget:
Go to Store Locator > Customize and open Location details
Under Show in the results list, turn Custom fields on or off for the location cards
Under Show when a location is open, turn Custom fields on or off for the details panel and the map popup
Select Save
You can also change the results list switch on the Custom Fields page: select Settings at the top, then Show in the results list.
These are all-or-nothing switches. 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 creation order. There is no drag-to-reorder control today. For new, empty fields, create them in the order you want them shown. Do not delete and recreate populated fields to reorder them, because deleting a field removes its saved values. Message us if existing fields need a different order.
Need a label beneath the location name?
For a shared category or program, a Location Type label may already fit. On the Native Modern style it appears beneath the location name without a field-name prefix. A location has one type, and changing it can also affect result priority, so preserve the intended order. This is not an independent per-location subtitle. See Location Types.
Editing and deleting fields
On the Custom Fields page, select a field to rename it, change its type or delete it. The page also shows how many locations have a value for each field.
Deleting a field removes it and all its data from every location. StoreRocket tells you how many locations lose a value before you confirm. 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 show on that location. Go to Locations, open the location, and fill in the value under Enrich > Custom fields.
Switch off? Go to Store Locator > Customize, open Location details, and check Custom fields. Use the one under Show in the results list for the cards and the one under Show when a location is open for the details panel and popup. The cards switch is off until you turn it on.
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 show in creation order, and the position within the card or popup is fixed by the widget template. If you need a field at a specific spot, create new fields in the order you want them shown. Do not delete populated fields just to change their order.
Import not picking up my fields
Check your CSV column header. It must start with Field: followed by a space and the field name, like Field: Store Number. A column with any other name isn't read as a custom field. The Import page lists it under To match. Rename the column in your file and upload it again.
Questions? Message us on live chat.