Skip to main content
Mix & Match Bundles, also known as Build-a-Box, let customers build their own bundle by choosing products and specific variants from a predefined selection. Use them for variety packs, samplers, gift boxes, and fully customizable bundles.

What is a Mix & Match Bundle?

A Mix & Match Bundle lets customers select a specific quantity of products (with optional variant selection) from a larger pool of options. You define which products are available, set minimum and maximum quantities, and configure tiered discount offers based on the number of items selected. Example: “Choose any 5-10 teas for up to 20% off” or “Build your own 6-pack: Pick 6 protein bars from 12 flavors”

Key features

  • Variant Selection: Customers can choose specific variants (size, color, flavor) for each product they add
  • Flexible Quantities: Set minimum and maximum product limits
  • Tiered Discounts: Offer better discounts for larger quantities
  • Multiple Selections: Customers can add the same product multiple times with different variants
  • Dedicated Build-a-Box Page: Standalone page with labelled steps, product prices, savings, a running total, and a sticky add-to-cart button
  • Translatable Text: Customize all UI text for international stores

Where the widget shows

Where to show this widget, with Target type for the mix and match bundle
The widget starts on the product pages in your pool, including products from the collections you use as the pool. To show it somewhere else, open the bundle and find Where to show this widget. Target type chooses the pages:
  • Specific Products shows it on the pool product pages you leave checked under Product pages, including products that come from the collections in the pool. Leave every product checked to keep it on the whole pool. Unchecking a product hides the widget on that product’s page. The products shoppers can pick stay the same.
  • Collections shows it on products in the collections you select there. That list is separate from the pool.
  • All Products shows it on every product page.
You can also exclude products or collections. This only changes where shoppers see the widget. The products they can pick, and the discount, stay the same.

When to use Mix & Match Bundles

Mix & Match Bundles work best for:
  • Variety packs: Letting customers sample different flavors, colors, or variants
  • Samplers: Try-before-committing bundles
  • Customizable sets: Giving customers control over their selection
  • Discovery bundles: Encouraging trial of multiple products

Creating a Build-a-Box Bundle

1

Select bundle type

From the Bundles page, click Create a bundle and select Mix & Match Bundle.
2

Define the product pool

Click Select Products. Products already in the bundle are selected. Add 3 or more products to give meaningful choice. Saving that picker does not add a second copy of a product that is already in the bundle. You can also source products from collections.
Mix and match products Mint Tea, Green Tea, and Black Tea
3

Set quantity limits

Under Item limits, set Minimum items and Maximum items to control the box size. For example:
  • Min: 3, Max: 6 allows customers to choose between 3-6 items
  • Min: 5, Max: 10 for larger variety boxes
Leave Maximum items blank for no maximum. Leave Minimum items blank to use the first tier’s quantity. The maximum must be the same as or more than the minimum. If an offer tier needs more items than the maximum, the editor warns you, because customers can’t reach that tier.Item limits is hidden when the bundle uses Product groups or Show as a product, which set their own counts.
4

Configure tiered offers

Set up quantity-based discount tiers in Tiers:
  • 3+ items: 10% OFF
  • 5+ items: 15% OFF
  • 8+ items: 20% OFF
Supports percentage, flat amount, or fixed price per item discounts.When you finish an offer, click the chevron in its header or Done to minimize it. A minimized offer shows its title and quantity; click the chevron again to reopen it. Minimizing only tidies the editor and doesn’t change the offer or what shoppers see.
5

Name and describe your bundle

  • Bundle name: Internal reference (e.g., “Tea Sampler Box”)
  • Bundle title: Customer-facing title (e.g., “Build Your Perfect Tea Collection”)
  • Subtitle (optional): Additional description shown below the title
6

Enable variant selection

Check Allow variants selection to let customers choose specific variants (size, color, flavor) for each product. This allows them to add the same product multiple times with different variants.
7

Customize text (optional)

Under Display Options, customize button text and validation messages for your store’s language and brand voice.
8

Get the Build-a-Box page URL

After saving, copy the Build-a-box page URL from the bundle editor to link directly to the standalone builder page.
9

Activate

Toggle to Active and select Save in the save bar.

Required items plus choose one

Use Product groups when your box needs a base kit and a required choice:
  1. Select Products 1, 2, 3, and 4 as individual products.
  2. Click Add group, name it “Base kit”, and turn on Required, always included. Assign Products 1 and 2 to this group.
  3. Click Add group again and name it “Your extra”. Leave Customer picks minimum and Customer picks maximum at 1. Assign Products 3 and 4 to this group.
  4. Configure your offer for 3 items, then save.
Products 1 and 2 start included and cannot be removed in the picker. Shoppers can still choose Product 1’s variant. They must choose Product 3 or Product 4 before adding the kit to their cart. Choosing the other product switches the selection. For an optional group with a minimum of 0 and a maximum of 1, customers can select one product, switch their choice, or uncheck it to leave the group empty. Each product belongs to exactly one group and can be selected once. Group limits replace the bundle’s minimum and maximum. Use individual products for groups; collection pools use the original selection flow. Remove all groups to return to that flow. To show groups as collapsible sections, choose the Sections style. Each section shows how many items shoppers have added, their picks are listed with a quantity stepper and remove button, and a total appears above the button. If every group is a single pick, the Curated set style shows one card with a row per group and a Change button that opens that group’s other products in place. Groups work in the theme block and with Show as a product. For a product listing, the groups must add up to an exact number of items. If a shopper removes a required item or breaks a group limit in the cart, that selection no longer receives the bundle discount.

Free gift

You can reward shoppers with a free gift when they fill the box.
  1. In the bundle editor, find the Free gift card and select Give a free gift with this box.
  2. Under Unlocked when, choose The box target is reached, or A group is filled and pick the group. The group option appears once the bundle has product groups.
  3. Select Choose gift products and pick up to 10 products. Shoppers choose a variant of the gift when it has more than one.
  4. Optionally set a Gift section title.
The gift appears in its own section on the widget. It is locked, with a message saying what is missing, until the box qualifies. Once it unlocks, shoppers choose their gift and it is added to the cart at no cost with the box. If the shopper later changes the cart so the box no longer qualifies, the gift is removed. A gift that is sold out is not offered. Turn on Free gifts in the Mix & Match editor to add one.

Show the bundle as a product

Turn on Show as a product to list the Mix & Match bundle in collections and search. You set the Product title, Description, Price, Compare-at price, and Image URL. Customers still pick the designs. The product itself cannot be bought on its own. Number of items is an exact count. Exactly 3 means they choose 3 items for one set. Turning Show as a product off clears this count, so set Minimum items and Maximum items again under Item limits. If they add another full set, that set costs the same Price again. Extra items that do not make a full set stay at their normal price. On the product page, the picker replaces Add to cart on that product only. If the Bundles (product page) block is already on the product template, the picker shows there. If it is not, turn on the Appfox Bundles app embed once (and keep Mix & Match on in Settings → Storefront features), or add the Bundles (product page) block from the theme editor. You do not edit theme code. Shopify keeps the product out of stock, so the cart, quick add on a collection card, and Buy it now cannot buy it. A collection card may show Sold out until the shopper opens the product. Each design they choose is added as its own item, and stock comes off that item. The Price is what they pay for one completed selection, in your shop currency. The product page and checkout convert it with Shopify’s presentment rate. With Markets price lists or rounding rules, the price on the theme’s product card can differ from the price in the picker and at checkout. It has to be the same as or less than the items they can pick, and saving is blocked when it is higher, because checkout cannot charge more than the items cost. Compare-at price must be higher than the price. The first time you turn this on, approve Appfox’s updated permissions so it can keep that product out of stock. Pausing the bundle drafts the product, so it leaves your storefront. Deleting the bundle removes the product. Turning Show as a product off drafts the product and keeps it. Activating the bundle does not publish that product again until you turn Show as a product back on. After you save, add the product to a collection, or use an automated collection that matches it. You can put it in the same collection as the designs. Customers never see it as one of the items to pick, and its product page shows only this bundle. If Shopify cannot use the Image URL, the save stops with an error and the current image stays. Clear Image URL to remove the image.

Bundle settings

Product pool

  • Minimum products in pool: 3 (to give customers choice)
  • Recommended: 6-15 products for optimal choice
  • Product types: Can mix product types, or keep within one category

Quantity settings

  • Required quantity: How many products customers must choose
  • Typical values: 3, 5, 6, or 10 items
  • Flexibility: Customers can choose any combination that meets the quantity

Discount options

Percentage discount:
  • Enter a percentage (e.g., 20%)
  • Applied when customers add the required quantity
Fixed bundle price:
  • Set a total price (e.g., $25)
  • Customers pay this price regardless of which products they choose
  • Great for “Any X for $Y” offers

How it appears on your store

Product page widget

Mix and match widget for Mint Tea, Green Tea, and Black Tea, showing 4.7 (12)
The widget displays:
  • Bundle title and subtitle
  • Tiered discount offers (e.g., “3+ ITEMS 10% OFF”, “5+ ITEMS 20% OFF”)
  • Grid of available products with images and prices
  • Quantity selector for each product (+ / - buttons)
  • Variant dropdown (when enabled) showing available options
  • Real-time validation messages
  • “Add to cart” button (enabled when quantity is within min/max range)

Dedicated Build-a-Box page

The standalone page (/apps/bundles?bundle=ID) includes:
  • Labelled steps: choose items, unlock the discount, then add to cart
  • Discount chips from your actual Mix & Match offers (percentage, fixed amount, or a set price)
  • Product cards with prices in your shop’s money format
  • A sticky summary with the selected count, savings, running total, and Add bundle to cart
  • A success message or a redirect to the cart after they add, matching the other Appfox widgets

Cart

Customers see:
  • Individual line items for each selected product/variant
  • Bundle identifier in line item properties
  • Discount applied automatically at checkout via Shopify Functions

Best practices

Include at least 6-12 products in your pool so customers feel they have real choice. With variant selection enabled, even fewer products can offer substantial variety (e.g., 6 products with 3 variants each = 18 options).
If your products have multiple variants (flavors, colors, sizes), enable Allow variants selection. This lets customers:
  • Choose 3 different flavors of the same tea
  • Mix sizes in a clothing bundle
  • Build a variety pack from a limited product set
  • Minimum: High enough to make the discount worthwhile (typically 3-5)
  • Maximum: Prevents oversized orders that might affect profitability (typically 10-20)
  • Show the range clearly: “Build Your Box (3-6 items)” in the title
Create compelling tiers:
  • 3 items: 10% off (entry tier)
  • 5 items: 15% off (sweet spot)
  • 8+ items: 20% off (bulk tier)
Each tier should feel like a meaningful upgrade.
If products have widely different prices, use percentage discounts rather than fixed pricing. This prevents customers from gaming the system by choosing only expensive items.
Use the translatable text fields to:
  • Match your brand voice
  • Translate for international customers
  • Create urgency (“Only more to get 20% off!”)
  • Provide helpful guidance
Mix & Match works best within a category (all teas, all protein bars, all candles) rather than across disparate categories. Customers understand the value better when products are related.

Example Mix & Match bundles

Food & Beverage

Coffee Sampler: Choose any 4 coffee bags from our collection for $40

Fashion

T-Shirt Bundle: Pick any 5 basic tees for $50 (usually $15 each)

Beauty

Bath Bomb Variety Pack: Select 6 bath bombs from 15 scents for $30

Snacks

Protein Bar Mix: Build your own 10-pack, choose from 12 flavors, 15% off

Pricing strategies

Scenario: All teas cost $8-$10 each
  • Offer: Choose any 5 for $35 (regular price would be $40-$50)
  • Benefit: Simple, clear value proposition
  • Customer behavior: More likely to explore different options
Scenario: Products range from $5 to $20
  • Offer: Choose any 6 items, get 20% off
  • Benefit: Fair discount regardless of selection
  • Customer behavior: May gravitate toward higher-priced items (which is fine)

Troubleshooting

Widget not showing products:
  • Verify bundle status is Active
  • Check that product pool has at least 2 products
  • Ensure products have available inventory
  • Check browser console for JavaScript errors
Variant dropdown not appearing:
  • Confirm Allow variants selection is enabled in bundle settings
  • Product must have multiple variants (more than the default variant)
  • Dropdown only appears when at least one unit is selected
Customers can’t add to cart:
  • Check that selected quantity is between min/max limits
  • Verify at least one offer tier is configured
  • Ensure selected quantity meets the minimum for at least one offer
Build-a-Box page not loading:
  • Verify the bundle ID in the URL is correct (/apps/bundles?bundle=123)
  • Check that the app proxy is configured in Shopify admin
  • Bundle must be Active status
Discount not applying at checkout:
  • Confirm Shopify Functions extension is deployed
  • Check that bundle products have the appfox_bundle property in cart
  • Verify offer conditions match the cart quantity
  • Test with a fresh cart (clear existing items)
Text not translating:
  • Custom text fields override defaults; set them per bundle if needed
  • Check Prisma migration ran successfully to add text fields
  • Verify bundle data includes custom text fields
Build-a-Box bundles have the highest engagement and average order value because customers love the customization. Use analytics to track which products and variants are most frequently chosen to optimize your product mix and pricing tiers.