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

# Quantity discounts

> Create volume breaks, tiered spend ladders, and bundle offers on Shopify through an AI agent connected to AIOD.

An AI agent connected to AIOD can set up quantity and tiered promotions: volume breaks, wholesale and bulk pricing, spend-more-save-more ladders, tiered free gifts and shipping rewards, and selectable bundle offers on the product page.

## Just ask

<CodeGroup>
  ```text You theme={null}
  Spend $50 get 10% off, spend $100 get 20% off.
  ```

  ```text You theme={null}
  Buy 2 get 10% off, buy 4 get 20% off.
  ```

  ```text You theme={null}
  Wholesale pricing: 5+ units 15% off, 10+ units 25% off.
  ```

  ```text You theme={null}
  Three bundle options on the product page — 1 at full price,
  2 for 10% off, 3 for 20% off plus free shipping.
  ```

  ```text You theme={null}
  Spend $75 get free shipping, spend $150 get free shipping and a free gift.
  ```
</CodeGroup>

## Which template gets used

All three are "tiered", but they behave differently — and picking the wrong one isn't cosmetic, because each allows a different set of fields.

| Template            | When                                                                                                                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tiered_unified`    | A straight ladder. Every tier uses the same kind of condition — cart quantity, item quantity, cart subtotal, or item subtotal — and only the number goes up. Rewards can differ per tier. |
| `volume_bundle`     | Quantity-only tiers on **one shared scope**, shown to shoppers as selectable bundle cards or a table.                                                                                     |
| `combined_discount` | Tiers with genuinely different conditions, or a mix of reward kinds that doesn't fit a ladder.                                                                                            |

Merchant-facing settings: [Tiered/Volume Discount](/docs/templates/tiered-volume-discount), [Volume Discount / Bundle](/docs/templates/volume-discount-bundle), [Combined Multi Discounts](/docs/templates/combined-multi-discounts).

## What the agent does

1. Reads the contracts — the three tiered templates differ in exactly the fields it's about to write.
2. Picks by the shape of the tiers: same condition with a rising number → `tiered_unified`; one shared scope shown as bundle cards → `volume_bundle`; genuinely different per-tier conditions → `combined_discount`.
3. Writes every tier out in full, each with its condition and its reward.
4. Decides stacking: by default the **highest unlocked tier wins**. Stacking every unlocked tier only happens if you explicitly ask.
5. Drafts it and hands you a link.

## Worth knowing

* **Tiers have a specific shape.** Each one needs a condition and a reward. An agent that invents its own tier format gets everything stripped and the draft rejected — which is why reading the contract first matters.
* **By default only the best tier applies.** If you want every unlocked tier to stack, say so.
* **Exclusions behave differently between templates.** In `tiered_unified` an exclusion is campaign-wide — the editor shows one control and applies it to every tier. In `combined_discount` it's genuinely per-tier.
* **In `volume_bundle`, every tier shares one scope** and only the quantity changes. Adding a free gift to an offer needs its own matching gift tier. Widget copy, badges, styling, and layout can't be set through MCP — configure those in the app.