> For the complete documentation index, see [llms.txt](https://docs.roadmap.so/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roadmap.so/discounts-and-gwp/troubleshooting/promotion-not-respecting-quantity-or-spend-limits.md).

# 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**.

{% hint style="info" %}
If you only change **Maximum number of uses per order**, the promotion can still trigger. It will just apply fewer times.
{% endhint %}

### Check the promotion in this order

{% stepper %}
{% step %}

#### Open the exact promotion

Confirm you are editing the same offer you are testing.
{% endstep %}

{% step %}

#### 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
  {% endstep %}

{% step %}

#### Check the per-order cap

Review **Maximum number of uses per order** if the issue is too many gifts in one cart.
{% endstep %}

{% step %}

#### Test with a clearly under-limit cart

Do not test $1 below the threshold.

Test well below, then well above.
{% endstep %}

{% step %}

#### Rule out overlap

Pause other live promotions and test again with a fresh cart.
{% endstep %}
{% endstepper %}

### 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.

### Related guides

* [Discounts not applying correctly](/discounts-and-gwp/troubleshooting/discounts-not-applying-correctly.md)
* [GWP not showing at checkout](/discounts-and-gwp/troubleshooting/gwp-not-showing-at-checkout.md)
* [Combine GWPs with loyalty rewards or bundles](/discounts-and-gwp/using-gwp-and-discounts/run-multiple-discounts-and-gwps/combine-gwps-with-loyalty-rewards-or-bundles.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roadmap.so/discounts-and-gwp/troubleshooting/promotion-not-respecting-quantity-or-spend-limits.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.