For the complete documentation index, see llms.txt. This page is also available as Markdown.

Checkbox

A list where the customer can select several values, and the standard way to offer a menu of optional paid extras.

A list where the customer can select any number of values. This type is always multi-select, so there is no Allow multiple setting.

Use it for a menu of extras such as toppings, add-on services, accessories, or upgrades. Each value can have its own price, and the total increases as the customer selects values.

Watch it done — 1:55. Letting customers select several add-ons at once — something Shopify variants cannot do — and pricing each one.

What customers see

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

A checkbox list on a storefront product page with several values ticked and their prices shown
A checkbox list, where the customer can select any number of values.

Basic

Setting
What it does

Customer-facing text, and the name on the order.

At least one value must be ticked.

Hides the label.

Default, Color, or Image.

Option values

The choices, with prices and their own help text. See Working with option values.

How many they must and may tick. Setting both the same means exactly that many.

Guidance for the whole option.

Pre-ticks one or more values.

Show or hide based on other choices.

Min selections and Max selections are displayed immediately for a Checkbox, unlike other multi-select types where they only appear after Allow multiple is enabled. This is because a Checkbox is inherently a multi-select option.

Advanced

Setting
What it does

How add-ons scale — including Mixed quantity.

Unlocks the collapsible layouts.

Expand or Collapse. No slider on this type.

Scroll type, Scroll height, Number of option values

Give a long list its own scroll area.

Vertical or Horizontal.

How sold-out values look.

Where the option-level help text sits.

Styling hook and field width.

Add-on pricing on a multi-select

This is the main difference from the single-select types: every selected value with a price is charged. Three selections at $4.00 each is $12.00.

Two settings matter here:

Setting
Why it matters here

Max selections

Your ceiling on the total. Without it a customer can tick everything.

Add-on quantity

Mixed quantity gives each value its own quantity box, so a customer can take two of one topping and one of another. Available on multi-select types only.

Mode
Three values ticked at $4.00, order quantity 2

Default

$24.00 — each extra follows the product quantity

One time charge

$12.00 — each extra charged once

Mixed quantity

Whatever the customer sets per value, multiplied as configured

See Advanced add-on modes.

Personalizer

Supported as an image layer. Each selected value can draw an image onto the product photo. The settings are image shape, background mode, size, position, rotation, crop area, and customer controls. See Image layers.

Several selected values mean several layers, which can overlap. Use the position settings to place each one.

Checkbox or Switch?

A Switch is for a single yes-or-no choice, with one price for the option. A Checkbox is for selecting from a list, with a separate price for each value.

Use a Switch when the customer can select exactly one extra, and a Checkbox when they can select two or more extras.

Examples

Pick any three toppings

Setting
Value

Label / Name

Toppings

Option values

Eight toppings, free

Min selections / Max selections

3 / 3

Help text

Choose exactly three.

Paid extras, capped at two

Values priced at $4.00 each, Max selections 2, and Add-on quantity set to One time charge.

A required acknowledgement

One value, I confirm the spelling is correct, with Required field on and no price.

Color add-ons with stock

Swatch style set to Color, each value linked to a generated add-on product, and Out of stock options set to Blur.

A long list, tidied away

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

Notes

  • Available on all plans.

  • Works in Shopify POS.

  • Always multi-select.

  • Required field means at least one value must be selected. To require exactly two, set both Min selections and Max selections.

  • There is no slider layout. Use Color swatch or Image swatch for that.

  • Every selected value appears on the order, so a customer who selects five values produces five entries.

Last updated

Was this helpful?