For the complete documentation index, see llms.txt. This page is also available as Markdown.

Promotion not respecting quantity or spend limits

Check whether the promotion trigger, spend rule, quantity rule, or per-order cap is causing the result.

This usually comes down to one of two things:

  • the cart still qualifies under Conditions

  • the wrong limit is being checked

Understand the two different limit types

Qualification limits

These decide whether the promotion triggers.

Examples:

  • Minimum Spend

  • quantity requirements in Buy X Get Y

  • required item mix in Buy A+B+C Get Y

Per-order usage limits

These decide how many times the promotion can apply in one order.

For gifts, this is Maximum number of uses per order.

If you only change Maximum number of uses per order, the promotion can still trigger. It will just apply fewer times.

Check the promotion in this order

1

Open the exact promotion

Confirm you are editing the same offer you are testing.

2

Check the condition type

Make sure the offer uses the right trigger:

  • Minimum Spend for spend-based rules

  • Buy X Get Y for product or quantity rules

  • Buy A+B+C Get Y for mix-and-match rules

3

Check the per-order cap

Review Maximum number of uses per order if the issue is too many gifts in one cart.

4

Test with a clearly under-limit cart

Do not test $1 below the threshold.

Test well below, then well above.

5

Rule out overlap

Pause other live promotions and test again with a fresh cart.

Common causes

The wrong condition type was selected

If you want "buy 2, get a gift", do not use Minimum Spend.

If you want "spend $X, get a gift", do not use a product-only condition.

The cart still qualifies

A cart can still meet the rule after other items are added.

Test with a very simple cart so the trigger is obvious.

Another promotion is being mistaken for this one

If two offers are active, the result may come from the other promotion.

You are looking for a discount line instead of a gift line

For a GWP, the correct result is usually the gift item in cart.

Best way to test

Build three separate carts:

  1. clearly below the threshold

  2. exactly at the threshold

  3. clearly above the threshold

Use a fresh cart each time.

Last updated