Variant offers, per-variant discounts & quantity limits

When you build an offer in a campaign, you don't have to offer a whole product. You can narrow it down to specific variants, give each variant its own discount, and cap how many of each a shopper can take. This page explains the Offer Products table in depth: choosing variants, the per-variant Discount, the per-variant Limit (Product Limit), and the Total Limit that controls how many different products a shopper can claim.

These controls live in the Offer Products section of a campaign's offer step. The exact set of controls you see depends on which funnel you're building — see Which funnels expose which controls below.

Whole product vs specific variants

When you add a product to the Offer Products table, you're choosing what the campaign offers. A product can be offered as a whole, or narrowed to one or more of its variants.

• Multi-variant products (a product with more than one variant — for example sizes or colors) show a variant picker. You can add the product and then keep only the variants you want to offer. Each variant you keep becomes its own row entry in the offer, identified by its variant ID and the option value (such as Large or Red).
• Single-variant products are added using their first (and only) variant automatically — there is no variant picker to narrow, because there's nothing to narrow.

In the table, each row shows the product image, title, status badge, and an ID you can click to copy. For a single-variant product the copied value is the Product ID; for a multi-variant product it's the Variant ID, shown alongside the option value (for example ID: 12345 - Large).

Recipe: offer only the "Large" variant as the free gift

Say you run a Gift with Purchase campaign and you only want to give away the Large size of a tote bag — never the Small.

The shopper now sees only the Large tote as the free gift, and no other size can be claimed from this campaign.

Per-variant discounts

Each row in the Offer Products table can carry its own Discount, set from the discount popover on that row. Discounts are stored per variant, so two variants of the same product can be discounted differently.

A few rules to keep in mind:

• A variant with no discount is offered at full price. Discounts are opt-in per variant — leaving a variant's discount empty means the shopper pays the normal price for it.
• To make a variant completely free (for example a true gift), use a Percentage discount of 100%.

For the full discount picker — including how discounts apply automatically at checkout and the limit on how many distinct variants a single condition can discount — see Applying discounts to offer products and the Discounts overview.

Recipe: a different discount per variant

You're offering a hoodie in two sizes and want to clear out Small stock harder than Large:

1. Add the hoodie and keep both the Small and Large variants.
2. On the Small row, set a Percentage discount of 50% off.
3. On the Large row, set a Percentage discount of 30% off.

Each variant now carries its own discount, and the shopper sees the correct price for whichever size they choose.

Per-variant quantity (Product Limit)

The Limit field on each offer row is the Product Limit — the maximum quantity a shopper can take of that specific variant. It's stored per variant, with a default of 1.

• The minimum you can enter is 1.
• Each variant you add starts at a Product Limit of 1 until you change it.

What the Product Limit controls depends on the funnel:

• On Auto-add offers, the Product Limit becomes the maximum quantity enforced on the line the app adds to the cart automatically — the app won't add more of that variant than the limit.
• On Gift with Purchase and Checkout Upsells offers, the Product Limit is the add-to-cart cap for that variant — the shopper can't add more of it than the limit allows.

Total Limit (the diversity limit)

While the Product Limit caps each variant individually, the Total Limit caps how many different products a shopper can claim from the offer overall. It's the "diversity" limit: the number of distinct products allowed, not the total number of items.

You don't always set the Total Limit by hand. On Auto-add campaigns the editor auto-computes it by summing the per-variant Product Limits — add up every variant's limit and that sum becomes the Total Limit. Adding a product, removing a product, or changing a Product Limit re-computes it.

On the storefront, the effective limit is the smaller of the Total Limit you set and the number of products that are actually available (in stock and offerable). So if your Total Limit is 5 but only 3 of the offered products are currently available, shoppers can claim at most 3 — the limit shrinks to match real availability.

How the two limits work together

Which funnels expose which controls

Not every funnel shows every control. The table below summarizes where each control appears.

Notes on the edges:

• On Checkout Upsells, the Limit field shows for manually selected (non-auto-add) offers. When a Checkout Upsells offer is set to add automatically, the per-row Limit field isn't shown.
• Product Recommendations offers are full-price recommendations and don't expose a Discount or a Limit on the offer rows.

For funnel-specific walkthroughs, see Gift with Purchase and Checkout Upsells.

Edge cases & cleanup behavior

Troubleshooting

• "Invalid diversity limit" on save — your Total Limit is 0 while the offer still contains products. Set it to 1 or higher. On Auto-add, raise at least one per-variant Product Limit so the limits sum to a positive number.
• Shoppers can claim fewer products than my Total Limit — the effective limit is capped by how many offered products are actually available. Check whether any offered products are out of stock or unavailable.
• A variant is offered at full price by mistake — that variant has no discount set. Open its discount popover and add a Fixed or Percentage discount.
• A size never appears as a gift — it was removed from the variant picker. Re-add the variant in the Offer Products table.

Related