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

# Volume Discount

> Offer Shopify volume discounts in Appfox: a percentage off when shoppers buy more of one product, including tiered thresholds on the product page.

Volume Discounts encourage customers to purchase multiple quantities of a single product by offering tiered discounts based on quantity purchased.

## What is a Volume Discount?

A Volume Discount applies a percentage discount when customers buy a specific quantity of a single product. Use it to encourage bulk purchases.

**Example**: "Buy 3 protein bars, get 20% off" or "Stock up: Buy 5, save 25%"

## When to use Volume Discounts

Volume Discounts work best for:

* **Consumables**: Products customers use regularly and need to replenish
* **Bulk purchases**: Encouraging customers to stock up
* **Reducing SKU complexity**: Simplifying inventory by moving more of fewer products
* **Subscription alternatives**: One-time bulk discounts instead of recurring subscriptions

## Creating a Volume Discount

**1. Select bundle type**

From the Bundles page, click **Create a bundle** and select **Volume**.

**2. Choose products or collections**

In the products section, choose **Apply quantity break to**: **Products**, **Collections**, or **Products and collections**. **Select collections** opens Shopify's collection picker (up to 25). You can use products, collections, or both. Collection membership is checked at checkout, so you do not need to add every product by hand.

**3. Set quantity threshold**

Enter the minimum quantity required (e.g., "Buy 3 or more").

![Volume offer settings for Buy 2 and Buy 3 on Green Hat](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/15-bundle-edit-volume.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=0e3979bbe8edd0f21859f671a7c0aa18)

**4. Set the discount**

Enter a percentage discount that applies when the quantity threshold is met (e.g., 20%).

**5. Name your offer**

Use a name like "Stock Up & Save: 20% off when you buy 3+" or "Protein Bar Bulk Discount".

When you finish an offer, click the chevron in its header or **Done** to minimize it. A minimized offer shows its title, quantity, discount and free gift on one line; click the chevron again to reopen it. When you open a saved bundle, its offers start minimized so you can see every tier at once. Minimizing only tidies the editor and doesn't change the offer or what shoppers see.

**6. Activate**

Toggle to **Active** and click **Save**.

## Bundle settings

### Product selection

* **Products**: One or more products, picked in the editor
* **Collections**: Whole collections, without listing each product. Choose **Collections** or **Products and collections** in the products section, then **Select collections**. You can combine products and collections. A quantity break can cover hundreds of products this way because collection membership is checked at checkout, not stored as a product list.
* **All products**: Apply the same tiers store-wide, with optional exclusions. Set this under **Where to show this widget**.
* **Variants**: Discount applies to all variants of a matching product
* **Quantity threshold**: Minimum quantity to qualify for discount
* **Counting mode**: **Per product** counts each product separately. **Combined** counts every matching line together, so mixed products from a collection can unlock a tier. New quantity breaks that apply to a collection, all products, or more than one product start on **Combined**. Existing bundles keep the mode you already chose.

### Discount

* **Type**: Percentage only
* **Range**: 1% to 99%
* **Application**: Applies when customer adds the threshold quantity or more to cart

## How it appears on your store

### Product page widget

![Volume widget with the seeded Buy 2 and Buy 3 tiers](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/46-volume-widget.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=299ff9dd5d0af33f035f88f3d99846e0)

The widget displays:

* "Buy X or more, save Y%"
* Product image and regular price
* Discounted price when threshold is met
* Quantity selector
* "Add to cart" button

Example: "Buy 3 or more, get 20% off. Regular: $10 each → Bundle: $8 each"

### Cart

When quantity threshold is met:

* Line item shows quantity and discounted price per unit
* Discount line item with total savings
* Clear indication of volume discount applied

If threshold is not met, the cart banner may suggest adding more to get the discount.

### Choosing a variant for each unit

In the Volume editor, open **Variants** and turn on **Allow variants selection**. The help text explains that this shows a variant picker for each unit in the selected quantity-break tier. For example, with a "Buy 3" offer, shoppers choose a size and colour for each of the three items and add all three to the cart in one click.

* **Picker style**: Pickers follow your **Variant display** (dropdown, buttons or swatches). Swatches fall back to buttons when the variants aren't colours. When a product has more than one option, each unit shows the colour as swatches (or buttons, when the colour has no swatch) and each other option, such as size, as its own dropdown or as buttons. The line above the units names the options, for example Color, Size. **Hide variants** collapses that list, and **Show variants** brings it back. Choosing a colour or size that is in stock in a different combination switches the other options to that combination. An option is disabled only when every variant with it is sold out. A product with one option keeps a single picker. The Quantity breaks template, and the Bold cards and Minimal outline looks, start with swatches.
* **Sold-out variants**: Each unit starts on the variant currently selected on the page. If that variant is sold out, it starts on the first variant that's in stock instead. Turn on **Hide sold-out variants** to remove sold-out variants from the pickers; otherwise they appear disabled.
* **Single-variant products**: Products with only one variant (after hiding sold-out ones) don't show pickers.
* **Higher quantities**: If the shopper raises the quantity on the product page above the offer's quantity, each extra unit gets its own picker too, up to 20 pickers. Units beyond that use the last picker's variant.

## Tiered discounts

While the app supports single-tier volume discounts, you can create multiple volume discount bundles for the same product with different thresholds:

* **Tier 1**: Buy 2, save 10%
* **Tier 2**: Buy 5, save 20%
* **Tier 3**: Buy 10, save 30%

Customers automatically receive the highest discount they qualify for.

## Free gift on a tier

Give shoppers a reason to pick a bigger tier besides the percentage: a free product, for example "Buy 3 + free travel mug".

1. Open the Volume bundle and find the offer (tier) you want to reward. If it's minimized, click the chevron in its header to open it.
2. Under **Free gift**, click **Choose gift product** and pick the product. If it has variants, pick the variant you want to give away.
3. Click **Save**.

To swap the gift, click **Change gift**. To stop offering it, click **Remove gift**.

On your store:

* The tier shows a **+ Free gift** bar along its bottom edge, with the gift's image and name. The bar uses the **Accent** color from the bundle's design settings.
* When a shopper adds that tier to the cart, the gift is added with it and is free at checkout.
* If the shopper later removes products or lowers the quantity so the cart no longer reaches the tier, the gift is removed from the cart. This applies on product pages, the cart page and the cart drawer, as long as the Appfox app embed or block is enabled in your theme. The gift is only free while the tier is reached.
* If the gift is sold out or can't be added, the products are still added to the cart without it.

> [!NOTE]
>
> The gift is a normal product in your catalog. Make sure it's available on your Online Store sales channel, otherwise it can't be added to the cart.

## Show gifts in their own section

By default each gift appears inside its tier. To list the gifts in a separate section below the tiers instead:

1. Set a gift on at least one tier, as described above.
2. Open **Free gifts** and, under **Progressive gifts**, turn on **Show gifts in their own section**.
3. Adjust the section:
   * **Gift section title** and **Gift section subtitle**: your own wording. Leave them empty for the built-in text, which is translated for each language.
   * **Hide gifts until customers unlock them**: shows a gift only once the selected tier gives it.
   * **Show labels for locked gifts**: tells shoppers how many items unlock a gift.
   * **Show product image for locked gifts**: shows the gift image before it's unlocked.
   * **Gift layout**: **List**, **Grid** or **Compact**.

A gift is unlocked while its tier is selected and locked while a higher tier is needed. Each gift is added with its own tier, so the gift of a lower tier isn't listed once a higher tier is selected.

## Show a progress bar

A progress bar above the tiers shows shoppers how close they are to the next tier. To turn it on, open the bundle and, in **Progress bar**, select **Show progress bar**.

The bar fills toward your largest tier and has a marker for each tier. The message above it changes with the quantity:

* **Add 2 more to unlock 20% Off**: the next tier's discount. When the next tier has no discount but has a free gift, the gift's name is shown instead.
* **You've unlocked the best deal**: the largest tier is reached.

The message is translated for each language. If the theme's quantity selector is on the page, the bar follows the quantity shoppers set there as well.

## Hide a tier's discount behind a scratch-off

To make a deal more fun to discover, you can hide a tier's discount behind a scratch card. Open the bundle, open the tier under **Tiers**, and select **Hide the discount behind a scratch-off**. You can turn it on for as many tiers as you like.

Shoppers see a scratch card over that tier's price. They reveal the discount in one of two ways:

* **Scratch it off** with a finger or a mouse. The discount appears once about half the card is scratched clear.
* **Select Reveal**, a button on the card that works with a keyboard and screen readers. If a shopper has asked their device to reduce motion, the card shows only this button.

Each tier is revealed once per browser session. After the reveal the tier works like any other, and the discount itself doesn't change. While a tier is hidden, the discount is also left out of the progress bar message and the add to cart button's price, and the tier's subtitle isn't shown. A tier with no discount has nothing to hide.

Scratch-off is available on Volume bundles only. The Analytics page doesn't show scratch-offs yet.

## Best practices

> [accordion] Start with modest thresholds
>
> Don't make the quantity threshold too high initially. "Buy 3" is more achievable than "Buy 10" for most customers. You can always increase it based on results.

> [accordion] Make the math easy
>
> Use round numbers and clear percentages. "Buy 5, save 20%" is easier to understand than "Buy 4, save 17%".

> [accordion] Emphasize per-unit savings
>
> Show both the percentage discount and the per-unit savings. "$10 → $8 each" is more tangible than just "20% off".

> [accordion] Consider your margins
>
> Volume discounts should encourage larger purchases while preserving profitability. Calculate your break-even point before setting discount percentages.

> [accordion] Target consumables
>
> Volume discounts work best for products customers buy regularly. One-time purchase products are less suitable.

## Example volume discounts

> [card] Food & Beverage
>
> **Protein Bars**: Buy 5 or more, save 20%. Regular $4.99 → $3.99 each

> [card] Beauty
>
> **Face Masks**: Buy 10 or more, save 30%. Regular $3 → $2.10 each

> [card] Home
>
> **Scented Candles**: Buy 3 or more, save 15%. Regular $20 → $17 each

> [card] Pet Supplies
>
> **Dog Treats**: Buy 6 bags or more, save 25%. Regular $12 → $9 each

## Pricing strategy

Calculate your volume discount using this approach:

1. **Determine your margin**: Know your cost and profit margin per unit
2. **Set the threshold**: Choose a quantity that encourages bulk buying but is achievable
3. **Calculate discount**: Ensure the discount is attractive while preserving acceptable margin

Example:

* Cost: $5, Regular price: $10 (50% margin)
* Volume threshold: Buy 5 or more
* Volume discount: 20% off (\$8 per unit)
* New margin per unit: \$3 (30%, lower but acceptable for higher volume)

## Combining with other offers

Volume discounts can run alongside other bundle types:

* Customer buys 5 units: Volume discount applies
* Customer buys 3 units in a Classic Bundle: Classic Bundle discount applies
* Shopify automatically applies the best discount available to the customer

## Troubleshooting

**Discount not applying**:

* Verify the customer added the required quantity to cart
* Check that all items are the same product (different variants of the same product qualify)
* If the widget shows on a collection, on all products or on several products, check **Counting mode** under **Where to show this widget**. With **Per Product**, a tier only applies when the cart has that many of one product, so a shopper who mixes products pays full price. Choose **Combined** if any mix of the targeted products should unlock a tier. The editor shows a warning when this applies.
* Ensure the bundle is active

**Threshold seems too high**:

* Edit the bundle and lower the quantity threshold
* Monitor analytics to see average quantity purchased
* Adjust based on customer behavior

> [!TIP]
>
> Track your volume discount performance on the [Analytics page](https://bundles-docs.getappfox.com/product-bundles/docs/dashboard/analytics.md). Look at average quantities purchased and adjust thresholds to optimize volume and profitability.


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