Skip to content
Install app
English

Radio button

A vertical list where exactly one choice can be made, and the clearest option type when the values need explaining.

A list where the customer selects one value. Unlike a dropdown, every choice is visible without opening anything, so use it when the values need to be read rather than only recognized.

This type is always single-select, so there is no Allow multiple setting. To let customers select several values, use Checkbox.

Watch it done — 1:14. Why upgrades hidden inside a dropdown get missed, and how a radio list puts every choice in front of the customer.

What customers see

A vertical list with a selectable marker beside each value. With Swatch style set, each value can also display a color chip or a picture.

A vertical radio button list on a storefront product page with help text under each value

Every choice is visible without opening anything.

Basic

SettingWhat it does
Label / NameCustomer-facing text, and the name on the order.
Required fieldBlocks add to cart until one is chosen.
Hidden labelHides the label.
Swatch styleDefault, Color, or Image.
Option valuesThe choices, with prices and their own help text. See Working with option values.
Help textGuidance for the whole option.
Default valuePreselects one value.
Conditional logicShow or hide based on other choices.

Radio button has no placeholder.

Advanced

SettingWhat it does
Add-on quantity / QuantityHow the add-on scales with quantity.
Enable custom layoutUnlocks the collapsible layouts.
Layout typeExpand or Collapse. No slider on this type.
Scroll type, Scroll height, Number of option valuesGive a long list its own scroll area.
Direction styleVertical or Horizontal.
Out of stock optionsHow sold-out values look.
Help text positionWhere the option-level help text sits.
HTML class / Column widthStyling hook and field width.

Per-value help text

Radio button supports help text on each value, and because the list is always open, that text is always visible. No other single-select type displays the explanation and the choice together.

Use this type whenever the choices need explaining:

○ Standard delivery
3–5 working days. Free.
○ Express delivery
Next working day if ordered before 2pm. +$9.95
○ Collect in store
Ready within 2 hours. Free.

A dropdown hides that text until it is opened, and a button row has no space for it.

Personalizer

Supported as an image element. Each value can have an image that is drawn onto the product photo when the value is selected. The settings are image shape, background mode, size, position, rotation, print area, and what customers can change. See Shape and fill.

Add-on pricing

Prices are set on each value, and each value supports all four modes. The option-level Add-on quantity controls how the charge scales.

Because only one value can be selected, there is either one charge or none. This makes Radio button a good type for tiered upgrades where the customer selects one level.

See Add-on pricing.

Radio button, Button, or Dropdown?

Radio buttonButtonDropdown
All choices visibleYesYesNo
Per-value help text visibleYesCrampedOnly when open
Suits long value namesYesNoYes
Vertical space usedMostLittleLeast
Slider layoutNoYesNo

Examples

Delivery speed

SettingValue
Label / NameDelivery speed
Option valuesStandard, Express, Collect in store, each with its own help text
PricesStandard free, Express $9.95, Collect free
Add-on quantityOne time charge, since delivery is per order
Default valueStandard
Required fieldOn

Three service tiers

Values Basic, Plus, and Premium, each with help text listing what it includes and its own price.

A finish, shown as colors

Swatch style set to Color, with values Matt black, Brushed brass, and Chrome, each with its color chip and its own lead-time note.

A long list, collapsed

Enable custom layout on, Layout type set to Collapse, and Scroll type set to By number of option values, showing eight.

Notes

  • Available on all plans.
  • Works in Shopify POS.
  • Single-select only.
  • There is no slider layout. Use Button or one of the swatch types for that.
  • There is no Not allow deselect setting. Use Required field with a Default value for a choice that can never be empty.
  • Values follow the order of the values table.

Was this helpful?

Report an issue