Why is my promotion not respecting quantity or spend limits?

What this usually means

If your promotion is triggering when it “shouldn’t,” it’s almost always because the cart you’re testing still matches the rules in the Conditions section, or because a different limit than you expect is actually being enforced.

Roadmap promotions are managed in Discounts / Gift with Purchase. The rule that controls when the promotion triggers lives under Conditions.

Quick checklist (in order)

Go to Discounts / Gift with Purchase, then open the promotion from the list (use the All and Active tabs if needed). Confirm the promotion’s Status and Schedule are what you expect.

In the promotion, scroll to Conditions and confirm which condition type you selected:

  • Minimum Spend (spend threshold)
  • Buy X Get Y (product/variant or collection + quantity requirement)
  • Buy A+B+C Get Y (multiple required items + quantity requirement)

If you’re expecting a quantity limit but the condition is set to Minimum Spend, the promotion will behave like a spend-based offer (and vice versa).

Still in the promotion editor, look for limit wording that matches your goal:

  • Minimum Spend: the order must reach the minimum amount you set.
  • Quantity requirements: controlled by the Buy X Get Y / Buy A+B+C Get Y conditions.
  • Gift quantity cap: controlled by Maximum number of uses per order (this is the setting that prevents multiple gifts in a single order when customers add more qualifying items).
If you only set Maximum number of uses per order, it won’t stop the promotion from triggering—it only limits how many times it can apply within one order.

Build a fresh test cart that is obviously below the rule you’re checking:

  • For Minimum Spend, test with a cart far below the threshold (not $1 below). Then test again far above it.
  • For quantity-based conditions, test with 0 qualifying items, then 1, then the exact required quantity.

This makes it easier to spot when another condition is actually responsible for triggering the offer.

Common reasons limits don’t behave as expected

If the promotion is still triggering, but you’re seeing “too many” gifts or too much discount, check whether you meant to cap usage rather than qualification.

  • Use Maximum number of uses per order to cap how many times the offer applies in one order.
  • Use Conditions (like Minimum Spend or a quantity requirement in Buy X Get Y) to control whether it qualifies at all.

When testing Minimum Spend, make sure you’re comparing the threshold against the same “spend” the promotion is using.

  • If a customer adds more items after the promotion triggers, the cart may remain qualified even if you remove an item later (depending on how you test).
  • If your promotion is meant to be product-specific, a spend threshold alone won’t prevent other items from contributing to reaching the minimum.
To isolate spend behavior, test with a cart that contains only the products you intend to qualify and adjust the quantities so the total clearly crosses the Minimum Spend line.

Examples:

  • If you want “Buy 2, get a gift,” you should be using Buy X Get Y (or Buy A+B+C Get Y) with the appropriate quantity requirement—not Minimum Spend.
  • If you want “Spend $X, get a gift,” use Minimum Spend—not a product-based condition.

When multiple offers run at once, you may be seeing the effect of another promotion.

Go to Discounts / Gift with Purchase and check the Active tab to see what else is live. If you’re running multiple offers, verify their Conditions don’t overlap in a way that causes a different promotion to trigger first.

For Gift with Purchase offers, “success” often appears as a new line item added to the cart—not necessarily a visible discount amount.

If you’re only watching for a discount value at checkout, it can look like your spend/quantity logic is wrong when the gift is actually being added/limited differently.

Where to check in the promotion editor

  • Status: confirm it’s active.
  • Schedule: confirm start/end dates.
  • Conditions: confirm Minimum Spend vs Buy X Get Y / Buy A+B+C Get Y.
  • Customer Eligibility: confirm the customer you’re testing is allowed to qualify.
  • Maximum number of uses per order: confirm per-order usage is capped if you’re trying to limit repeated applications.
If you change a promotion while testing, re-load your cart and test again. Otherwise, you may be observing cached cart state or an older version of the promotion rules.