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, certifications, or anything specific to your business.
Once you create a field and populate it for your locations, 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 down to the Custom Fields section. You'll see all the fields you've created. Fill in the values and save.
This works great for a few locations, but if you have hundreds, importing is way faster.
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 up automatically on location cards once they have values. Each field appears with its name as a label and the value next to it.
If a location has an empty value for a field, that field simply won't show on its card. No blank labels cluttering up the widget.
Editing and deleting fields
To rename a field, go to your Fields page and click on the field to edit it. The new name will update everywhere, including on the widget.
To delete a field, click the delete button on the Fields page. This removes the field and all its data from every location. There's no undo, so make sure you're certain before deleting.
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
The most common reason: the field is empty for that location. If you created a field but didn't fill in the value, nothing will display. Go to Locations, edit the location, and check the Custom Fields section.
Import not picking up my fields
Check your CSV column header. It must follow the exact format Field: Name with a capital F, a colon, and a space before the field name. If you used Fields: Name, field: Name, or just the field name without the Field: prefix, the import will skip it.
Wrong values after import
Make sure the field name in your CSV matches the field name in StoreRocket exactly. "Store Number" and "Store number" are treated as two different fields. Check your Fields page for the exact names.
Questions? Hit us up on live chat.