> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Quantity upsells
> Offer one product at several quantity tiers on the post-purchase page, with a bigger discount, a free unit, or a free gift at higher tiers.
A Quantity upsell shows one product at two to five quantity tiers on the post-purchase page. Each tier carries its own discount, so the buyer pays less per unit the more units they take. The buyer picks a tier and accepts in one click, and the units are added to the order they just placed.
Quantity upsells offer a single product. To let a buyer assemble several different products into one order, use [Build a box](/aftersell/build-a-box) instead.
## How a quantity upsell works
1. The buyer completes checkout and lands on the post-purchase page.
2. The offer shows the product once, with a tier card for each quantity you configured.
3. One tier starts selected. You choose which, and you can mark a different tier as recommended.
4. The buyer switches tiers, picks variants if you allow it, and accepts.
5. Aftersell adds the tier's units to the original order at the tier's discount.
Because the units land on the existing order, the buyer pays no second shipping charge and enters no card details again.
## Starter templates
Pick a template when you create the offer. Each one sets up the tiers, copy, and card styling for a different selling pattern, and you can change anything afterwards.
| Template | What it sets up |
| --------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Quantity upsells** | Tier cards stacked as rows, with a percentage discount on each tier. The general-purpose starting point. |
| **Side-by-side quantity upsells** | The same tiers laid out as columns on a wide screen, stacking back to rows on a phone. |
| **Buy X, get Y free** | Tiers that add free units on top of the paid ones, so the top tier reads "Buy 2, get 1 free". |
| **Free gift unlock** | Tiers that unlock a separate free gift product when the buyer selects them. |
## Create a quantity upsell
1. Open the funnel you want to add the offer to.
2. Select **Add offer**, then choose the quantity option from the menu.
3. Choose one of the four starter templates.
4. In **Product selection**, choose the product source.
5. In **Quantity tiers**, set the quantity and discount for each tier.
6. In **Card style**, adjust the layout, width, and colors.
7. Save and preview the funnel.
In the current editor the offer menu entry still reads **Quantity breaks**, which is the feature's former name. Everywhere else in the editor it appears as **Quantity upsells**. Both refer to the same offer type.
## Product selection
A quantity upsell offers exactly one product, so you select one product source. If you select more than one, the funnel will not save.
You can use any of these sources:
* **Specific product.** Hand-pick the product every buyer sees.
* **Automatic upsell (AI).** Shopify's Recommendation API picks a complementary product from the buyer's order.
* **Most expensive in cart** or **Least expensive in cart.** Re-offers the highest or lowest priced item the buyer just bought.
* **Collection.** Aftersell resolves one product from the Shopify collection you pick.
* **Strategy.** A [Strategy](/aftersell/implementing_strategies_post_purchase_upsells) resolves the product against your rules each time the offer is shown.
Each dynamic source resolves to a single product before the tiers are priced and authorized, so the tier discounts always apply to the product the buyer is actually shown.
Changing the product source clears any variant choices saved on your tiers, because those variants belong to the previous product. Re-check the **Variant selection** setting on each tier after you switch sources.
## Quantity tiers
Each offer holds between two and five tiers. Every tier needs a different combination of quantity and discount, or the funnel will not save.
| Setting | What it controls |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Quantity** | How many paid units this tier adds to the order. |
| **Free quantity** | Extra units added at 100% off on top of the paid ones. This is what makes a "buy X, get Y free" tier. |
| **Discount type** | Percentage (0 to 100) or a fixed amount off. |
| **Card title** | The headline on the tier card. Supports `{quantity}`. |
| **Subtext**, **chip text**, **price text**, **band text** | The supporting copy on the card. See the character limits below. |
| **Purchase options** | Whether this tier is a one-time purchase, a subscription, or lets the buyer choose. |
| **Variant selection** | Whether the buyer picks variants, and how many. |
| **Free gift** | An optional gift product unlocked by this tier. |
You also set which tier starts selected and which tier carries the recommended badge. They can be the same tier or two different ones.
### Copy limits
| Field | Maximum characters |
| ---------- | ------------------ |
| Card title | 80 |
| Subtext | 100 |
| Chip text | 40 |
| Price text | 40 |
| Band text | 60 |
### Text variables
Use `{quantity}` in tier copy to print that tier's pack size. Subscription tiers also support `{subscription-price}`, `{subscription-percent}`, and `{cadence}`.
## Purchase options
Each tier sets its own purchase mode:
* **One-time.** The units are added as a standard one-time purchase.
* **Subscription.** The units are added on a selling plan. You can restrict which of the product's selling plans the buyer may choose.
* **Both.** The buyer picks one-time or subscription on the card, and you set which option starts selected.
Subscription and Both need the product to carry selling plans. A product with no selling plans can only use one-time tiers.
## Variant selection
A tier handles variants in one of three ways:
* **Buyer selects.** One selector on the card, applied to every unit in the tier.
* **Locked.** You pick the variant, and the buyer cannot change it.
* **Per unit.** One selector for each unit, so a buyer taking three units can pick three different variants. Available on one-time tiers, up to 20 units. You can label the slots and set a default variant for each.
At the offer level, **Variant preselection** decides which variant starts selected:
| Option | Behavior |
| ------------------------------------ | -------------------------------------------------------------------- |
| **Best match from initial purchase** | Matches the variant the buyer already bought. This is the default. |
| **First available** | The first variant that is in stock. |
| **Highest price** | The most expensive variant. |
| **Require user selection** | Nothing starts selected, and the buyer must choose before accepting. |
## Free gifts
Any tier can unlock a free gift, added to the order at 100% off. The **Free gift unlock** template starts you with this configured.
Per gift you set:
* **Gift product** and which of its variants are allowed.
* **Gift quantity**, up to 20 units.
* **Gift name**, which falls back to the product's own name. Supports `{quantity}`.
* **Gift variant selection**, either one variant for the whole gift or one per unit. Per-unit selection needs a gift quantity above 1.
* **Free badge** text, which defaults to `FREE ~~{value}~~`. `{value}` prints the gift's retail price and `~~text~~` strikes text through. Removing `{value}` hides the price.
* **Locked label** and locked styling, shown before the buyer selects that tier. Supports `{quantity}`, for copy such as "Buy {quantity} to unlock".
**Gift behavior** applies to the whole offer, not to one tier:
* **Cumulative.** Selecting a tier grants its gift and every gift below it.
* **Selected tier.** Only the selected tier's gift is granted.
The gift ladder can sit **full width** below the tiers, or **inline** inside the tier column. You can also set the header shown above the gifts, up to 80 characters.
## Card style
| Setting | Options |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Tier layout** | Rows or columns. |
| **Card width** | 400 to 800 px, in steps of 50. |
| **Corner radius** | Any value from 0 up. |
| **Colors** | Surface, border, title, subtext, price, compare-at, chip, and band colors, each as a six-digit hex value. Selected cards take their own surface and border colors. |
| **Recommended badge** | Text up to 30 characters, a pill, ribbon, or rectangle shape, an optional icon, a font size, and background and text colors. |
Individual tiers can override the offer's colors if you want one tier to stand out beyond the recommended badge.
## Pricing and compare-at
**Use compare-at price** controls the struck-through reference price on the card. It affects display only and is not part of the discount Aftersell authorizes, so changing it never changes what the buyer is charged. On variants with no compare-at price, the list price is used instead.
## Things to know
* **Sold-out tiers show as sold out.** If Aftersell cannot secure stock for a tier when the offer is prepared, that tier renders as sold out rather than as a card that silently fails on accept.
* **Shopify limits post-purchase acceptances.** A buyer can accept up to two post-purchase offers per order. See [multi-step offers](/aftersell/how_to_create_a_multi_step_post_purchase_upsell) for how this interacts with longer funnels.
* **Buy X, get Y free adds two lines.** The paid units and the free units are added as separate lines of the same variant, which keeps the totals exact. Both lines belong to the same order.
## Related
* [Build a box](/aftersell/build-a-box)
* [Post-purchase offer types](/aftersell/post-purchase-offer-types)
* [Configuring post-purchase offer settings](/aftersell/configuring_post_purchase_offer_settings)
* [Translating post-purchase funnels](/aftersell/translating_post_purchase_funnels)