Skip to main content
Storefront widget & display

How to let customers pick a variant per item (swatches)

For a quantity-break offer in Bundlex Bundles, turn on the variant selector to let shoppers choose a size, color or other option for each unit. For example, a Buy 2 offer can contain one Small Ivory bag and one Large Blush bag. Choose dropdowns, color swatches, buttons or variant images to make those choices clear.

Turn on the variant selector

This setting lives in the Variant selector card on the Add-ons tab of the bundle editor. A switch in the card's header shows whether it is on or off.

  1. Open the bundle you want to edit, go to the Add-ons tab, and find the Variant selector card.
  2. Turn on the switch in the card's header.

For regular quantity-break and Buy X, get Y offers, enabling this setting gives each unit its own choice. With it off, an unpinned regular offer follows the theme's selected variant. Product-bundle cards and main products pinned to a set of variants can still have an in-card picker.

Bundlex Variant selectors and swatches Add-ons tab with Variant selector enabled, Color swatches, Size pills, per-item images and the hidden theme picker settings beside the bag preview.
In Add-ons, (1) enable Variant selector, (2) choose each option's display type and preset, and (3) check the color values. The preview shows these choices.

What the toggle controls

Regular offers use this toggle for the main product's per-unit picker. A Product bundle main card keeps an in-card picker even when the toggle is off, so shoppers can choose alongside the other required products. Required bundle products, gifts and optional extras also keep their own choices when applicable. A pinned main product can also keep a plain picker when the toggle is off, restricted to the variants you pinned.

With the toggle off, product-bundle rows use plain dropdowns. With it on, the configured display types also style the required bundle-product rows. Gift and optional-extra pickers use their own controls. A product with only one selectable variant can show its identity as text instead of an unnecessary dropdown.

Set the display type for each option

Once the toggle is on, Bundlex Bundles loads the variant options found on the products this bundle applies to and lists them in a table with three columns: Option, Display type, and Preset. Each row is one option (for example Size or Color).

In the Display type column, choose how that option appears on the product page:

  • Dropdown - a standard select menu.
  • Color swatch - small color chips. Lets you assign a color to each value (see below).
  • Pill / Button - tappable pills or buttons, optionally with the variant image.
  • Variant image - shows each value as its product image.
  • Dropdown with images - a select menu with a small photo next to each value, in the closed box and in the open list. Useful for long color lists.

You can mix types across options, for example a color swatch for Color and a dropdown for Size on the same product. Click the view (eye) icon next to an option name to show a product that has that option in the preview panel.

Pick a shared preset

The Preset column sets the visual style for a display type. Presets are shared per type: all options that use the same display type share one preset, so changing the preset for one option updates every other option of that type. Color swatch, Pill / Button, and Variant image each have their own set of presets; Dropdown and Dropdown with images have no preset.

Choose Custom in the preset menu to open the Swatch style section, where you can fine-tune the styling beyond the built-in presets.

Dropdown with images has no preset but has one style setting: open Swatch style > Dropdown with images and set Photo size, from 16 to 48 px (20 by default). It sets the photo in the closed box; the open list shows each photo at that size or at 28 px, whichever is larger. A plain dropdown on the same row grows to the same height, so the two line up. This size is separate from the color swatch size and its presets.

Assign colors for color swatches

When an option uses the Color swatch display type, each of its values gets a color field with a color picker. You can:

  • Set each color manually with the picker or by typing a hex value.
  • Click Auto-detect colors to fill in colors automatically from the value names (for example "Navy" or "Forest green"). Auto-detect only fills values that are still empty and is unavailable once every color is set.

Show color names on desktop

Open Swatch style > Color swatch and turn on Show color name on hover for a color-name tooltip. It applies to color chips, not every display type. Touch devices do not have a hover tooltip; to name the picked color on a phone, tick Show selected values in the label under Style > Widget style > Variant label.

Show the variant image

Turn on Show variant image (available once the selector is enabled) to display the selected variant's image next to the variant selector. This works for any selector type, not just the variant image display type.

Hide the theme variant picker

With the selector enabled you also get Hide theme variant picker. This hides your theme's default variant selector so only the Bundlex Bundles picker is visible. The theme's selector is hidden with CSS rather than removed, which allows the normal theme integration to keep the main product image in sync. Test that behavior on your theme.

If the main product image does not update when a variant is selected, you may need to adjust the Variants block selector in the Bundlex Bundles app embed settings so it matches your theme. Reach out to support if you need help with this.

Fold long per-unit lists

Collapse variant selectors folds each unit's choices into a row that opens one at a time. This can keep a larger quantity-break offer compact. It does not apply to Product bundle offers.

Test choices, stock and prices

Save and activate the discount, then test an eligible product on the storefront. This demonstration uses Lithuania with USD. In this example, the Small Ivory bag costs $24 and the Large Blush bag costs $30. A Buy 2 offer at 10% off totals $48.60. Add it with the actual Add to cart button and confirm both colors, both sizes and the total in cart and checkout.

Quilted Cosmetic Bag product page showing independent Ivory Small and Blush Large selections in Buy 2, a $48.60 offer total and enabled Add to cart.
(1) Ivory / Small and (2) Blush / Large are independent selections. (3) Their combined discounted product subtotal is $48.60; the actual cart and checkout confirmed both variants.

A sold-out combination can stay visible and selectable while Hide unavailable variants is off. Choosing Blush / Small in this demo displays an unavailable message and blocks Add to cart. Choosing the available Large size restores the button. A combination that does not exist at all is different: the picker can move later options to a valid combination, so check the final size after changing a color.

Quilted Cosmetic Bag page with sold-out Blush Small selected in the second row, an unavailable message and disabled Sold out purchase button.
(1) Blush / Small remains visible with hiding off. (2) The unavailable message explains why (3) the normal purchase button is disabled. Choosing Large restores Add to cart.

To remove sold-out values from supported pickers, open Advanced > Offers and stock > Hide unavailable variants. Availability follows Shopify's inventory policy; a zero-stock variant that allows continued selling can still be available. See variant option availability for scope and fallback details.

When there is nothing to choose

When the whole selectable set has exactly one variant, a dropdown collapses into the variant name on the card. Configured pills or color swatches can remain visible as a selected badge. Products with only Shopify's default variant do not need a picker.

This is why a picker you expected can be missing. It usually means one of the following:

  • The product genuinely has one variant.
  • You pinned the item to a single variant.
  • Hide unavailable variants is on and only one variant is left in stock.

Restocking a variant or widening the pinned selection brings the picker back on its own. The main offer and required bundle-product cards follow this picker-to-identity behavior. Gifts, upsells and add-ons have their own availability filtering; a sole available choice may not display a separate variant name.

Reload options after editing variants

If you add, rename, or remove variants on your products after setting this up, click Reload options at the top of the variant options table to pull in the latest options. Bundlex Bundles confirms with a "Variants updated" message when something changed, or "Reloaded, no changes" when the option set is already current. Save any resulting changes before checking the storefront. New colors visible in the editor are not published until saved.

If no options appear

The variant options table needs product option data for the bundle's targeting and required bundle products. If options are still loading, allow that process to finish before treating an empty table as a configuration problem. If you see a prompt to select products or collections, set that up in the Show widget on section first. If you instead see "No variant options found for the selected products," the selected products have no variant options to configure.

Was this article helpful?

Your feedback helps us improve our docs.

Thanks - we'll keep improving this article.

Want to chat with our team? Still have a question?

Still need help?

Our team is one click away. Send us a message and we'll get back to you.

We use a few cookies to keep this site working, measure how it is used, and power our chat widget when you open it. See our cookie policy.