Option ElementsSelection TypesDropdown

Dropdown

A collapsed select menu. The customer clicks to open the list and picks one option. All choices are hidden until the customer opens the dropdown.


When to use

  • Many choices (8+) where showing all at once would take too much space
  • A compact field where a radio list would dominate the form
  • Size charts with a long list of sizes

For fewer choices (2–6) where side-by-side visual comparison matters, use Radio Buttons or Button Group instead.


General settings

SettingDescription
LabelField label
RequiredCustomer must select a value (not the blank placeholder)
Help textGuidance below the field
PlaceholderText of the blank default option before a selection is made (e.g., “Select a size”)
Search suggestionAdds a search box inside the dropdown — the customer types to filter the options list. Recommended when there are 10+ options.
Don’t allow deselectOnce the customer makes a selection, they cannot clear back to the placeholder. Useful when a value should always be set after first interaction.
Allow multipleTurns the dropdown into a multi-select — the customer can pick more than one option. The dropdown stays open between picks.
Min selectionsMinimum number of options to select (when Allow multiple is on)
Max selectionsMaximum number of options selectable simultaneously

Dropdown settings showing Required field, Don't allow clearing the selection, Min selections, Max selections, and Allow multiple selections

Scrolling down reveals two more sections — Per-Option Quantity (lets the customer set how many of a selected option they want, multiplying its price and setting the cart line quantity) and Add-on Quantity (only relevant for values priced via a linked product):

Dropdown settings scrolled to show Per-Option Quantity and Add-on Quantity sections


Values tab

Each value is one option in the dropdown list:

FieldDescription
LabelText shown in the dropdown list and in the order
Internal nameAdmin-only
DefaultPre-selected when the page loads
DisabledGreyed out in the list (e.g., out of stock). Customers can see it but cannot select it.
ImageOptional thumbnail shown next to the label in the open dropdown list
PriceAdd-on price for selecting this option. See Add-On Pricing.

Drag values to reorder them. Click + Add to add another value, or use Bulk add values to paste in a list at once:

Dropdown Option values table with Wood and Steel values, each with a price field

Click More on any value to expand its pricing options. The Price rule dropdown controls how that value’s price is calculated:

Price ruleBadgeDescription
Flat amountNative BC ruleUses the price you entered directly
Percentage of base priceNative BC ruleCharges a percentage of the product’s base price instead of a fixed amount
Conditional on another fieldApp-calculatedOnly charges this price when another element on the same option set matches a condition you set

Each value also has an If out of stock setting — Show, Hide, Blur, or Strike — controlling how it appears if the linked inventory runs out.

Dropdown value pricing expanded showing Flat add-on price and Flat amount price rule

Dropdown value pricing showing Percentage of base price selected as the price rule

Dropdown value pricing showing Conditional on another field selected as the price rule


Storefront behavior

  • Displays as a custom-styled dropdown menu.
  • With search enabled: a search input appears at the top of the open list
  • Multi-select shows selected values as removable tags in the trigger

Single selection

The selected option is recorded on the order. In the order the line reads: [Element label]: [Selected value label] — e.g. Size: Large.

Multi-select (Allow multiple on)

Each checked value appears as its own line on the order. In the order, every selected value appears as a separate line:

Size - Small: Yes
Size - Large: Yes

Unselected values are not listed. After toggling Allow multiple on or off, open the element in the admin and click Save — the app automatically updates the behind-the-scenes setup in BigCommerce.