Skip to main content

Create a custom store field and show it on a card

Use custom fields for structured information that is not part of the built-in store record, such as services, dining options, warranty period, accessibility features, or pickup types.

This example creates a checkbox field named Serving with Dining and Take Away choices.

1. Create the field​

  1. Go to Store Locator → Custom Fields.
  2. Select Add New.
  3. Enter Serving as Label.
  4. Enter serving as Key.
  5. Set Applies To to Stores.
  6. Set Field Type to Checkboxes.

The key is the permanent machine name used by stored values, designs, imports, and integrations. Use lowercase letters and underscores, and do not change it casually after stores contain data.

2. Add choices​

Under Choices, add:

LabelValue
Diningdining
Take Awaytake-away

The label is what administrators or visitors read. The value is the stable stored value. You can improve a label later without breaking saved records, but changing a stored value requires updating existing data and imports.

3. Choose where the field appears​

Use Show for categories to limit the field to relevant store categories. Leave it empty when every store should have the field.

Use Show in tab to place it in an existing Store editor tab or create an appropriate grouping. Enable Show in list filters only if administrators or public locator controls genuinely need to filter by this field.

Save the custom field.

4. Add values to a store​

  1. Go to Store Locator → Stores and edit a relevant store.
  2. Open the tab selected for the field.
  3. Select Dining, Take Away, or both.
  4. Save the store.

If the field does not appear, confirm the store belongs to one of the categories selected under Show for categories.

5. Display the value on a Store Card​

  1. Go to Store Locator → Builder and open a Store Card.
  2. Add a Store field content element.
  3. Choose Serving under Store field in the inspector.
  4. Add an optional icon, prefix, or suffix.
  5. Set desktop and mobile widths.
  6. Save the card and test a store with one choice, both choices, and no choice.

Choice labels should be used for display; raw values such as take-away are intended for storage and integration.

Before deleting a field​

Search Builder designs, Store records, filters, imports, and custom integrations for the field key. Deleting the definition can leave saved values or design references that no longer render.