> ## Documentation Index
> Fetch the complete documentation index at: https://bundles-docs.getappfox.com/product-bundles/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bundle types overview

> Compare Appfox bundle types on Shopify: Quantity breaks, Mix & match, Complete the bundle, Classic bundle, Buy X, get Y, and Frequently bought together, and how Shopify Functions apply each discount at checkout.

Product Bundles by Appfox offers five bundle types, each designed for different merchandising strategies. Choose the type that best matches how you want to group and discount your products.

## Available bundle types

> [card] [Quantity breaks](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/volume-discount.md)
>
> Discount when shoppers buy more of a product

> [card] [Mix & match](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/mix-and-match.md)
>
> Shoppers pick items from a set

> [card] [Complete the bundle](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/fixed.md)
>
> Shoppers buy this exact set together and save a percentage

> [card] [Classic bundle](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/classic.md)
>
> Shoppers choose a variant of each product. The discount applies when all of them are in the cart

> [card] [Buy X, get Y](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/bogo.md)
>
> Buy one, get one free or discounted

> [card] [Frequently bought together](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/frequently-bought-together.md)
>
> Recommend add-ons on the product page

## Comparison

| Bundle Type | Best For | Discount Type | Customer Choice |
| - | - | - | - |
| **Quantity breaks** | Stock-up offers | Percentage | Quantity only |
| **Mix & match** | Variety packs, samplers | Percentage or fixed | Choose from selection |
| **Complete the bundle** | An exact set, bought together | Percentage | Exact quantities |
| **Classic bundle** | A variant choice on each product | Percentage or fixed | Variants |
| **Buy X, get Y** | Cross-selling, upselling | Percentage or free | None (fixed products) |
| **Frequently bought together** | Accessories and add-ons | Optional percentage | Pick which items to add |

## Choosing a bundle type

### Use Classic when

* You want to bundle specific complementary products together
* Products naturally go together (phone + case + screen protector)
* You want to control exactly which products are in the bundle
* Example: "Complete Workout Set" (dumbbells + resistance bands + yoga mat)

### Use Fixed when

* You want customers to buy a specific number of items together
* Products are from the same category but you want to enforce quantity
* You're offering a "buy X, save Y%" deal on specific products
* Example: "Buy these 3 skincare products together, save 20%"

### Use Mix & Match when

* You want customers to build their own combination
* You have many variants or flavors
* You're creating variety packs or sampler sets
* Example: "Choose any 5 teas for \$25" or "Build your own 6-pack"

### Use Volume when

* You want to discount a single product purchased in quantity
* You're encouraging bulk purchases or stockpiling
* You want tiered pricing (buy 2 save 10%, buy 3 save 20%)
* Example: "Buy 3 protein bars, get 20% off"

### Use BOGO when

* You want to encourage adding a second product
* You're promoting new products alongside bestsellers
* You want classic BOGO deals (buy 1 get 1 free/50% off)
* Example: "Buy any dress, get a belt 50% off"

## How discounts apply

All bundle types use Shopify Functions to apply discounts automatically at cart and checkout:

* **No discount codes needed**: Discounts apply when customers add qualifying products to their cart
* **Cart visibility**: Customers see the discount line item in their cart
* **Checkout visibility**: Discounts carry through to checkout
* **Order tracking**: Bundle discounts appear in order details

## Creating a bundle

**1. Choose your bundle type**

From the home page or Bundles page, click **Create a bundle** and select the bundle type that matches your strategy.

**2. Configure products and pricing**

Select products, set bundle name, choose discount type (percentage or fixed amount), and enter discount value.

The editor is split into sections such as **Products**, **Settings** and **Style**. Tap a section's title to open or close it. Optional features such as **Badges** or **Countdown timer** have a checkbox: tapping the title of one that is off turns it on. To turn a feature off, clear its checkbox.

**3. Customize appearance**

Adjust colors, labels, and preview how the bundle appears on your storefront.

**4. Activate the bundle**

Click **Activate** to make the bundle live. It will appear on product pages for included products.

## Bundle limits

* **Products per bundle**: No hard limit (recommend 2-10 products for best customer experience)
* **Active bundles**: Unlimited
* **Products in multiple bundles**: Yes, a product can be in multiple bundles
* **Bundle combinations**: Multiple bundle types can be active simultaneously

> [!TIP]
>
> Start with one or two bundles to test performance, then expand based on results. Most successful stores run 3-8 active bundles.

## Offer an upgrade after Add to cart

For volume discounts, fixed bundles, and frequently bought together bundles, enable **Offer this bundle after Add to cart** in the bundle editor and save. Volume and fixed bundles have this option in **Settings**.

Keep the **Bundles (product page)** block on your product template. To offer upgrades from collection quick-add buttons, enable the **Appfox Bundles** app embed in your theme editor.

After a shopper adds a single item with your theme's Add to cart button, a popup offers the next volume tier or the full set. **Upgrade to bundle** updates the cart; **No thanks** keeps the original item. For volume bundles, choose the offered tier under **Tier to offer** in **Customer targeting**: the next tier up, the highlighted (preselected) tier, or a specific tier. Each product is offered once per browser session. Your schedule and customer targeting still apply. Subscription items and products without an available upgrade do not show an offer.

In **Analytics**, the bundle table includes **Upgrade views** and **Upgrade accepts**. Completed upgrade purchases contribute to the bundle's **Revenue**, alongside purchases from the widget. You can translate the popup text from **Translations**.

## Offer a bundle when shoppers are about to leave

For volume discounts and fixed bundles, enable **Offer this bundle when shoppers are about to leave** in the bundle editor under **Customer targeting** and save. Keep the **Bundles (product page)** block on your product template: the offer is the bundle your shopper was already looking at.

When a shopper on that product page moves to leave without adding anything to the cart, a popup shows the bundle and what they save. On a computer, it appears when the pointer leaves through the top of the window. On a phone or tablet, it appears after a quick scroll back up the page, as a panel at the bottom of the screen that covers less than half of it and does not stop shoppers from using the page. It does not appear in the first few seconds on the page, and your browser's Back button works as usual.

* The popup lists what **Add Bundle to Cart** adds and the total. **Add Bundle to Cart** adds the bundle and opens your cart. **No thanks**, the close button and the Escape key close it, and on a computer so does a click outside it.
* Each shopper sees it at most once per browser session, and never after they add anything to the cart or when their cart already has items. If the shopper picked a variant that is sold out, no offer is shown. Your schedule and customer targeting still apply. Bundles with required personalization fields are not offered.
* To give an extra discount, enter a Shopify discount code under **Extra discount code (optional)**. It is applied at checkout when the shopper accepts the offer. Bundle discounts are product discounts, so create an order discount code (for example a percentage off the order) under **Discounts** in Shopify, turn on **Product discounts** in the code's combinations, and turn on **Order discounts** under **Combinations** in the bundle editor. If the two cannot combine, Shopify applies only one of them, and an order where the bundle discount did not apply is not counted as bundle revenue.

To test the offer on your store, open the bundle's storefront preview and move your pointer out through the top of the window after a few seconds. A preview does not use up the once-per-session limit, so you can reload and try again.

In **Analytics**, the bundle table includes **Exit offer views**, **Exit offer accepts** and **Exit offer revenue**. Revenue from accepted offers is also part of the bundle's **Revenue**. You can translate the popup text from **Translations**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.