> ## Documentation Index
> Fetch the complete documentation index at: https://help.yuko.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Quantity Discounts

> Per-product quantity tiers — buy 3 of Product A, get 10%; buy 6, get 20%.

Quantity Discounts apply tiered discounts **per product**: "Buy 3
quantities of Product A, get 10%. Buy 6, get 20%." Each product's own
quantity is what counts — customers can't combine different products to
reach a tier (for that, use
[Volume discount bundles](/bundles-discounts/offers/volume-discount-bundles)).

**Create it:** **Create Offer → Volume Discounts → Quantity discounts**.
The editor has three tabs: **Offers block**, **Design**, and
**Settings & Schedule**.

## Offers block tab

### When to display

The **When to display...** card decides which product pages show the
offer. Choose under **Applies to:**

* **All products** — the offer renders on every product page
* **All products except selected** — everywhere except the products you
  pick
* **All products except selected collections** — everywhere except the
  collections you pick
* **Products in selected collections** — only products in the selected
  collections
* **Specific selected products** — only the products you pick
* **Products with specific tags** — products carrying any of the tags you
  enter (comma separated)

For product/collection modes, type in the search field or click **Browse**
to open the Shopify picker.

<Note>
  The **Products with specific tags** option is available for quantity
  breaks, quantity discounts, volume discounts, and Related Products — the
  bundle forms don't offer it.
</Note>

### Offer title

The block heading, with an eye toggle to hide it and the
**Add horizontal line on both sides of offer title** checkbox.

### The Tiers card

Tiers appear as tabs (**Tier 1**, **Tier 2**, …) with **Add another tier**
to add more and a trash button to delete (hidden when only one tier
remains). New tiers pre-fill with a title like `Buy any 3 items` and a
badge like `⭐ 15% Off`.

Each tier has:

| Field                               | What it does                                                                                                              |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Title                               | Shown to customers on the product page, in their cart, and at checkout                                                    |
| Minimum quantity / Maximum quantity | The quantity range this tier covers — leave the maximum blank for "and above". Ranges must be unique and must not overlap |
| Discount type                       | **Percentage**, **Fixed amount**, **Final tier price**, or **Price per quantity**                                         |
| Discount value                      | The `%` or currency value (percentage capped at 100)                                                                      |
| Subtitle                            | Secondary line under the title                                                                                            |
| Badge                               | Attention badge on the tier, with an eye toggle to show/hide                                                              |
| Colors (Show more)                  | **Badge background** and **Badge text** color pickers                                                                     |

Discount type notes:

* **Fixed amount** shows the heading *Discount (per product)* and warns:
  make sure the amount isn't bigger than the product's price, or the item
  can't be added to cart.
* **Final tier price** fixes one price for the whole range — the app
  warns: customers pay the same amount anywhere between the minimum and
  maximum quantity of that tier.
* **Price per quantity** shows the heading *Price per item* — customers
  pay that per-unit price in this range.

## Design tab

A **Themes** carousel with 21 ready-made looks (Default, Green Lilly,
Soft Blue, Art Deco Elegance, Corporate Blue, Simple, Orange Sale,
Elegant Vertical, Standard Mono, Blissful Serenity, Black & White, Dark
Elegance, Summer, Forest Haven, Joyful Harvest, Matte Neutral Calm,
Midnight Blue, Midnight Luxe, Modern Contrast, Modern Monochrome,
Nature's Touch), plus sliders, colors, and typography.

<Info>
  Design options — themes, every color picker, typography, and layout —
  are covered in depth in
  **[Design & themes](/bundles-discounts/customization/design-themes)**.
  Changes preview live in the **Product page preview** panel as you edit.
</Info>

## Settings & Schedule tab

Identical to the quantity breaks settings: **Pricing** (total vs per
item), **Additional settings** (variants per item, quantity selector,
nearest-lower-tier discount, out-of-stock message, hide currency), then:

Under **Combinations**, control whether this deal stacks with other
Shopify discounts — **Deal combines with other store discounts:**

* **Order discounts**
* **Product discounts**
* **Shipping discounts**

Untick a class to prevent the deal from combining with discounts of that
class at checkout.

**Customer eligibility rules** restrict who gets the offer. Choose
**All customers** or **Specific customer segment**, then click **Add
rule** — multiple rules combine with **AND**:

| Rule                                | What it checks                                                           |
| ----------------------------------- | ------------------------------------------------------------------------ |
| Customer's status                   | Customer must be logged in or logged out to qualify                      |
| Customer's tags *(logged-in only)*  | Choose which customer tags qualify — include or exclude, comma separated |
| Country                             | Customers using your shop from specific countries — include or exclude   |
| Amount spent *(logged-in only)*     | Minimum spend / Maximum spend across past purchases                      |
| Orders completed *(logged-in only)* | Minimum order / Maximum order count to qualify                           |

<Note>
  Tag, spend, and order-count rules only work for **logged-in customers**
  — guests can't be matched against their history.
</Note>

Under **Schedule**, choose how long the campaign runs:

* **Run campaign continuously** — the campaign runs until you deactivate
  it
* **Run campaign on schedule** — the campaign runs between the selected
  dates: set **Start date** and **Start time**, and optionally tick
  **Set end date** to add an **End date** and **End time** (times pick in
  30-minute increments; past dates are disabled)

## Use cases & examples

<AccordionGroup>
  <Accordion title="Case pricing for B2B" icon="boxes-stacked" description="1–5 at list price, 6–11 at 10%, 12+ at 20%.">
    Three tiers with ranges 1–5, 6–11, and 12–no max. Use **Percentage**
    discounts, and leave the last tier's maximum blank for "and above".
  </Accordion>

  <Accordion title="Per-unit price drops" icon="arrow-trend-down" description="$8 each up to 5 units, $6.50 each from 6 up.">
    Use **Price per quantity** — each range sets the unit price
    customers pay, shown under the *Price per item* heading.
  </Accordion>

  <Accordion title="Storewide 3-for-10% rule" icon="store" description="Every product gets the same per-product tier table.">
    Set **Applies to: All products** — each product page shows the tiers,
    counting only that product's quantity.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Customers mixing products don't get the discount">
    That's by design — Quantity Discounts count each product separately.
    If "any 3 items from the collection" is the goal, use
    [Volume discount bundles](/bundles-discounts/offers/volume-discount-bundles)
    instead.
  </Accordion>

  <Accordion title="The widget doesn't render">
    Check the **Yuko Extension** embed (red **Not Visible** badge in the
    Offers list = disabled), the **When to display...** targeting, offer
    status, and the overlap banner for conflicts with other active
    offers.
  </Accordion>

  <Accordion title="A tier never seems to apply">
    Tier ranges must not overlap and must be unique — the form flags
    "Quantity ranges must not overlap." Check for a gap between ranges
    too: with tiers 1–3 and 6–10, quantities 4–5 get no tier (or the
    nearest lower tier's discount if that setting is on).
  </Accordion>
</AccordionGroup>

## Need help?

<CardGroup cols={3}>
  <Card title="Book a call" icon="calendar-days" href="https://cal.com/yukoteam/yuko">
    Schedule a free call with our team for personal setup assistance.
  </Card>

  <Card title="Contact support" icon="comments" href="#crisp-chat">
    Chat with us directly — we're happy to help with any question.
  </Card>

  <Card title="Install Yuko Bundle Builder & Discounts" icon="download" href="https://apps.shopify.com/yuko-bundles-quantity-discount">
    Get [Yuko Bundle Builder & Discounts](https://apps.shopify.com/yuko-bundles-quantity-discount) from the Shopify App Store.
  </Card>
</CardGroup>


## Related topics

- [Quantity Breaks & Free Gifts](/bundles-discounts/offers/quantity-breaks-gifts.md)
- [Volume discount bundles](/bundles-discounts/offers/volume-discount-bundles.md)
- [Overview](/bundles-discounts/overview.md)
- [FAQ & troubleshooting](/bundles-discounts/troubleshooting.md)
- [Design & themes](/bundles-discounts/customization/design-themes.md)