> ## 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.

# Classic Bundle

> Create a Shopify Classic bundle in Appfox: fixed products, shopper variant choices, and a percentage or fixed discount applied automatically at checkout.

Classic Bundles let you package specific products together and offer them at a discounted price. Shoppers can select specific variants (size, color, etc.) for each component, and the discount applies automatically at checkout.

## What is a Classic Bundle?

A Classic Bundle combines a fixed set of component products at a discounted price using Shopify's discount function. Shoppers select variants for each component, add them to cart, and the discount applies automatically when all components are present.

**Example**: "Complete Home Office Bundle" containing desk lamp + mouse pad + pen holder at 20% off. Shoppers choose their preferred variants and the discount applies at checkout.

## When to use Classic Bundles

Classic Bundles work best for:

* **Complementary products**: Items that naturally go together (phone + case + charger)
* **Complete solutions**: Everything needed for a specific use case
* **Gift sets**: Pre-curated bundles for gifting
* **Multi-variant products**: Bundles where shoppers need to choose sizes, colors, or styles

## How classic bundles work

![Classic bundle widget for Canvas Bag and Water Bottle, showing 4.7 (12)](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/49-classic-widget.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=a2424826581bb3c479f2decedd3dfa19)

1. **Shopper views bundle** on a component product page
2. **Selects variants** for each component (size, color, etc.)
3. **Adds to cart** - component products are added with bundle metadata
4. **Discount applies** automatically at checkout when all components are present
5. **Inventory decrements** for the actual component products purchased

This uses Shopify's discount function to apply your configured discount (percentage or flat amount) at checkout.

## Creating a Classic Bundle

**1. Create the bundle**

Go to **Bundles** → **Create bundle** → **Classic**

**2. Add products**

Search and add the products you want to bundle together. Set the quantity for each product. You can also select **Add from collection** to select up to 20 collections at a time and add the current products in one or more collections. Review the added products, remove any you do not want, and set their quantities. Products already in the bundle are not added again. Later changes to the collection do not change this bundle.

Shopify's discount function can store 10 KB of data for all your **Active** bundles combined. Appfox stores product lists compactly, so that is roughly 700 products in total across your Active bundles. If adding a collection would go over that limit, Appfox adds as many products as fit and shows a warning. Remove products, save the bundle as **Paused**, or use a quantity break that targets **Collections** instead of listing every product.

![Classic bundle products Canvas Bag and Water Bottle](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/08-bundle-edit-classic.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=e18ef3591c04fe2a569d760417673b1a)

**3. Set the discount**

Choose between:

* **Percentage discount**: Enter a percentage (e.g., 20%). Applies proportionally to each component.
* **Fixed amount discount**: Enter a dollar amount (e.g., \$15 off). Distributes proportionally across components.

**4. Configure settings**

* **Status**: Active (visible on storefront) or Paused (hidden)

**5. Preview and save**

Review the bundle preview. When ready, set status to **Active** and click **Save**. Saving also creates a Shopify product for the bundle so you can sell it as its own item, in addition to the product-page widget. Appfox publishes that product to your **Online Store**. If Shopify asks you to approve publishing permissions, approve them and save again. On that product's page, the **Bundles (product page)** app block lists the products included in the bundle. If Shopify cannot create that product, the save is blocked and the error is shown.

## Where the widget shows

![Where to show this widget, with Target type for the classic bundle](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/39-widget-targeting-classic.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=c8d2ba435955e46e590bce340fdb8449)

Open the bundle and find **Where to show this widget**. **Target type** chooses the product pages that show it:

* **Specific Products** lists each component and this bundle's own product under **Product pages**. Leave every box checked to show the widget on each of those pages. Uncheck the components and leave the bundle product checked to show the widget only on the bundle's own product page. Unchecking a page hides the widget there. The products in the bundle stay the same. A bundle that has never had this list saved still shows the widget on every component page and on the bundle product page.
* **Collections** shows it on products in the collections you select.
* **All Products** shows it on every product page.

You can also exclude products or collections. This only changes where shoppers see the widget. The discount still applies to the products in the bundle.

## Pricing examples

### Percentage discount

**Bundle:** T-Shirt ($25) + Pants ($50) = $75 total   **Discount:** 20% off   **Final Total:** $60 (save \$15)

The discount applies proportionally: 20% off each component.

### Fixed amount discount

**Bundle:** T-Shirt ($50) + Pants ($30) = $80 total   **Discount:** $10 off\
**Final Total:** \$70

The discount is distributed proportionally:

* T-Shirt: $50 / $80 × $10 = $6.25 discount
* Pants: $30 / $80 × $10 = $3.75 discount

### Different variant prices

**Bundle:** T-Shirt (Small: $20, Large: $25) + Hat (\$15)\
**Discount:** 20% off

**Shopper selects Small T-Shirt:**

* Subtotal: $20 + $15 = \$35
* With 20% off: \$28

**Shopper selects Large T-Shirt:**

* Subtotal: $25 + $15 = \$40
* With 20% off: \$32

The discount applies correctly regardless of which variants are chosen.

## Variant selection

Shoppers can select specific variants for each component product:

* **Size**: Small, Medium, Large, etc.
* **Color**: Red, Blue, Green, etc.
* **Material**: Cotton, Polyester, etc.
* **Any product options**: Works with all Shopify product options

The storefront widget shows variant selectors for each component, and the displayed total updates as selections change.

## Technical details

### Discount function

Classic bundles use a Shopify discount function to apply discounts at checkout. The function:

* Detects when all bundle components are in the cart (by `_appfox_classic_bundle_id` attribute)
* Applies the configured discount (percentage or flat amount)
* Only activates when **all required components** are present in the correct quantities

### Cart attributes

Each component product added to cart includes:

* `_appfox_classic_bundle_id`: Links the item to the bundle (used by discount function)
* `appfox_bundle`: Bundle ID for analytics and order tracking

### Inventory management

Component products' inventory decrements normally when purchased. Shopify tracks inventory for the actual products added to cart.

### No variant limits

The discount function approach works with any number of variant combinations. There are no limits on:

* Number of product options
* Number of variants per product
* Number of variant combinations in the bundle

## Best practices

### Choose complementary products

Select products that naturally go together or solve a common problem:

* ✅ Shirt + Pants + Belt (complete outfit)
* ✅ Laptop + Mouse + Laptop Bag (work setup)
* ❌ Random unrelated products

### Set attractive discounts

* **10-15%**: Good starting point for most bundles
* **20-25%**: Strong incentive for higher-value bundles
* **\$X off**: Works well when you want a specific price point

### Clear product descriptions

Help shoppers understand what's included:

* List all component products clearly
* Mention that they can choose variants
* Highlight the savings

## Troubleshooting

### Discount not applying at checkout

**Possible causes:**

* Not all required components are in cart
* Components were added without bundle metadata (added separately, not via widget)
* Bundle status is Paused
* Discount function not deployed

**Solutions:**

* Ensure shopper adds all components via the bundle widget
* Check bundle status is Active in admin
* Verify discount function extension is deployed

### Wrong discount amount

**Cause:** Multiple bundle sets in cart

**Solution:** The discount applies per complete bundle set. If a shopper adds 2x each component, they get 2 bundles' worth of discount (expected behavior).

### Variant prices not matching

**Cause:** Component product prices changed after bundle was created

**Solution:** The discount function uses current product prices at checkout automatically. No action needed - prices always stay up to date.

### Components added separately don't get discount

**Cause:** Items must be added via the bundle widget to include bundle metadata

**Solution:** This is expected. Shoppers must use the bundle widget to get the bundle discount. Items added separately (from product pages) won't have the bundle attributes.

## FAQs

> [accordion] Can shoppers buy just one component without the discount?
>
> Yes. If they add a single component product via its normal product page (not the bundle widget), it's added at regular price with no discount.

> [accordion] What happens if a component is out of stock?
>
> Out-of-stock variants cannot be selected in the bundle widget. If all variants of a required component are out of stock, the bundle cannot be purchased.

> [accordion] Can I change component prices after creating the bundle?
>
> Yes. The discount function uses current product prices, so price changes automatically apply. The bundle always shows the latest prices with the discount.

> [accordion] Do Classic bundles work with subscription products?
>
> Yes. Turn on **Let shoppers subscribe to this bundle** in the widget settings. It works when every component product has a selling plan with the same name. See [Sell a bundle as a subscription](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/fixed.md#sell-a-bundle-as-a-subscription).

> [accordion] Can I limit who sees the bundle?
>
> The bundle widget appears on component product pages for all visitors. Use **Status: Paused** to hide bundles. For customer-specific offers, consider discount codes instead.


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