Choice sources, labels, values, and multiple selection

Choice fields can obtain their options from seven sources. The source controls the option value sent to search and the label shown to visitors.

Supported sources

Choices source	Options produced
Custom list	Lines entered manually as value:label
Categories	Active locator Categories; values are Category IDs
Brands	Active Brands; values are Brand IDs
Countries	Country-code choices
Distinct values of a store field	Unique non-empty values from Name, Status, City, State, Postal code, Country, address fields, Phone, Email, or Website
Distinct values of a custom field	Unique values stored under one custom-field key
Number range	Generated values from Min, Max, and Step

Enter a Custom list

Under Choices, enter one option per line:

dining:Dining
take-away:Take Away
delivery:Delivery

The left side is sent/stored as the value. The right side is displayed. When no colon exists, the same text is used for both.

Automatic taxonomy sources

Mapping a field to Category, Brand, or Country automatically selects Categories, Brands, or Countries as the effective source unless explicitly changed. Do not build a static Category list: IDs can differ between sites and new categories would not appear automatically.

Distinct-value sources

Use a distinct Store field or custom field when values are managed on Store records rather than a centralized taxonomy. Empty values are excluded. Correct spelling/casing inconsistencies on Stores before using this source or visitors may see duplicate-looking options.

Number ranges

Set Min, Max, and Step. For 0, 100, and 25, the generated choices are 0, 25, 50, 75, and 100. Map the field to a numeric custom field and choose the intended comparison.

Multiple selection

Select, Chips, Accordion, Popup, and Options List can enable Allow multiple selections. Options List can also show removable selected chips above the always-visible list. Category multiple selection matches stores belonging to any selected category.