Storefront

Variant Pickers

5 min read

When a bundle product has more than one variant, shoppers pick which one they want from inside the widget, without leaving the product page.

Variant pickers are available on Fixed Bundle, BOGO, Buy X Get Y, Volume Discount, and Mix & Match bundles.

#How it works per bundle type

Fixed Bundle, BOGO, Buy X Get Y, Volume Discount

Each product in the bundle that has more than one variant gets its own choice, on its row in the bundle editor: Shopper picks one or Include all. The choice only appears on products that have more than one variant.

Shopper picks one: shoppers see a picker for that product in the widget and choose one variant. The price shown for that product, and the bundle total, update as they switch.
Include all: every variant you have selected is required. The app adds all of them to the cart as separate line items.

The selected variants show as chips under the choice. Edit variants changes which ones are offered.

Mix & Match

Mix & Match has no such choice. Every product in a group that has more than one variant shows a picker when the shopper selects it (variant and quantity). There is nothing to enable.

Frequently Bought Together

The main product follows your theme's own variant picker: the variant the shopper picks on the page is the one in the set, and its name shows under the product. An add-on offered in more than one variant gets its own picker. An add-on you set to one variant shows that variant's name instead.

#Configuring variant pickers (Products step)

Open your bundle and go to the Products step.
Find a product row that has more than one variant. Under its name you will see the variant count, e.g. 3 of 5 variants.
Click Edit variants to choose which variants are included in the bundle.
Pick Shopper picks one or Include all for that product.

#Variant picker style (Products step)

Once at least one product in your bundle is set to Shopper picks one, a Variant picker card appears at the bottom of the Products step. It applies to every product in the bundle that offers a choice.

Pickers: how the picker groups its options:

Setting	What it does
`One per product`	Shoppers choose from full variant names, like "Midnight Navy / Small".
`One per option`	One picker per product option, like Colour and Size.

Picker style: how each picker draws its values:

Setting	Best for
`Dropdown`	Options with many values. Opens a list to save space.
`Buttons`	Options with a few values. Every choice visible at a glance.

A product set to Shopper picks one, and the Variant picker card with One per option and Dropdown

Storefront bundle widget showing a variant picker using Buttons style, with Flavour and Size options on the first product

The picker uses the colours set under Colors in the style customizer (Settings → Widget style), so it matches the rest of your widget.

#The all-variants-checked warning

If you select every variant of a product and choose Include all, the editor shows a warning banner:

To fix it: choose Shopper picks one for that product, or deselect some variants so you are including only the specific options that belong in the bundle.

The warning fires when: Include all is chosen and the number of selected variants equals the product's total variant count and more than one variant is checked.

Bundle editor warning banner reading Every variant is checked

#Sold-out handling

After a shopper switches to a different variant, the widget immediately re-checks stock. If the newly chosen variant is unavailable, its card is marked sold out. With Block the bundle when a product is sold out on (Settings → General), the add-to-cart button is also locked until the shopper switches back to an in-stock variant.

#Checklist layout: auto-tick

In the Checklist layout, picking a variant counts as opting in to that product. The row is automatically ticked so shoppers do not have to confirm the same choice twice. If the row was already ticked, switching variants leaves it ticked.

#Mix & Match per-product variant choice

When a shopper taps a product to add it to their Mix & Match selection, the variant picker appears in the product popup. They choose their variant there before it is counted toward the group minimum, and that exact variant is what goes into the cart.

#Common mistakes

"Buy 1 Get 21" on a reward product. If your Buy X Get Y reward product has 20 variants and you choose Include all with every variant selected, the deal requires all 20 variants in the cart before the discount applies, and the storefront advertises it that way. Choose Shopper picks one so shoppers can pick one.

Expecting the picker card on every bundle. The Variant picker card on the Products step is hidden when no product in the bundle is set to Shopper picks one. Switch it on for at least one product and the card appears.

Editing variants without checking the switch. Edit variants changes which variants are included. The Shopper picks one / Include all choice controls whether shoppers pick one of those or whether all of them are required. You need both set correctly.