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

Switch

A single on-or-off toggle with its own label, for offering one paid extra.

A toggle the customer turns on or off. It provides a single yes-or-no choice.

Use it for one optional extra, such as gift wrapping, express production, insurance, or an extended warranty.

What customers see

A toggle with your label above it and a short label beside the toggle. The switch label is Yes by default.

A switch option turned on, on a storefront product page, with its add-on price shown
A switch reads as a single decision, which suits one paid extra.

Basic

Setting
What it does

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

Blocks add to cart unless the switch is on. Rarely what you want — see the note below.

Hides the label above the switch. The switch label stays.

Selected by default

The switch starts in the on position. Off by default.

Switch label

The short text beside the toggle. Starts as Yes. Required.

Guidance that stays visible.

The add-on charge when the switch is on.

Show or hide based on other choices.

Advanced

Setting
What it does

How the add-on scales with quantity.

Where the help text sits.

Styling hook and field width.

Add-on pricing

The price applies to the whole option and is charged when the switch is on. All three modes are available:

Mode
Use for

Existing product

Something you already sell and stock, such as a gift box.

New product

Something physical you want to count and stock without building a product by hand.

Fixed amount

A service with nothing to stock, such as express production. Not supported on POS.

The Add-on quantity mode is especially important on a Switch:

Mode
On an order of three products, with $5.00

Default

$15.00 — one per product

One time charge

$5.00 — one for the whole order

Fixed quantity with Quantity 2

$10.00 — always two

Use One-time charge for anything charged once per order rather than per item, such as gift wrapping a parcel or a delivery upgrade. See Advanced add-on modes.

Personalizer

Not supported.

Switch or Checkbox?

Switch
Checkbox

Number of choices

Exactly one

A list of any length

Price lives on

The option

Each value

Multiple selection

Not applicable

Built in

Swatch style

No

Yes

Reads as

A single yes-or-no decision

A menu of extras

Use a Switch for a single option. Use a Checkbox when there are two or more.

Examples

Gift wrap, charged once per order

Setting
Value

Label / Name

Gift wrap

Switch label

Yes, wrap it

Selected by default

Off

Price

New product $3.00

Add-on quantity

One time charge

Express production

Switch label Yes, prioritize my order, New product $10.00, One time charge, help text Made and dispatched within 24 hours. A once-per-order fee needs a product-backed mode; Fixed amount cannot be combined with One time charge.

A confirmation the customer must give

Label Spelling check, switch label I confirm the spelling above is correct, Required field on, no price. Use this together with an engraving field.

An upgrade most people take

Label Premium gift box, Selected by default on, a price attached, and help text stating the price clearly.

Notes

  • Available on all plans.

  • Works in Shopify POS, provided the add-on is product-backed rather than Fixed amount.

  • No Personalizer support.

  • When the switch is on, the Switch label text is stored in the order. Use a switch label that reads clearly on an order line. Yes, wrap it is clearer than Yes.

  • Conditional logic on a Switch offers two operators: is enabled and is disabled. See Operators reference.

Last updated

Was this helpful?