> ## Documentation Index
> Fetch the complete documentation index at: https://order-limit.xrtotech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify order limit not working? Troubleshoot the rule

> Check rule status, feature switches, scope, customer identity and timing. Isolate overlapping rules and record cart evidence when limits behave differently.

When Order Limit does not behave as expected, fix one product, one customer and one test cart. Change one setting at a time so you can identify the cause.

**1. Check activation**

Confirm the rule is not **Draft**. Reopen it after saving to check the stored values. Price, weight and customer rules need their own overview switches enabled.

For quantity restrictions, check the appropriate **Enable quantity rules** or **Enable product quantity limits** switch and confirm **Cart and checkout validation** is enabled.

**2. Check products and calculation**

Verify the actual cart products are selected. Collections use current membership. Check whether the quantity calculation is individual or combined.

**3. Check customer identity**

Sign in with the correct account for tag tests. Check tags in the Shopify customer profile, confirm **Add tag** was used, and verify matching versus non-matching conditions.

**4. Test at the right stage**

Checkout-only rules do not check cart interactions. Quantity minimums also check at checkout. Successful add-to-cart alone does not prove the rule is failing.

**5. Isolate other rules**

Check list order, variant limits, combined rules and cumulative rules. Temporarily set unrelated rules to drafts, test, then restore them one at a time.

## Troubleshoot by symptom

| Symptom | Check first |
| - | - |
| VIP allowance is too low | Sign-in, tags, earlier general rules, variant and combined caps |
| Items below the quantity minimum can be added | Enter checkout to test the minimum |
| Amount seems sufficient but checkout is blocked | Applicable current line amounts, exclusions, discounts, market conversion |
| Calculated weight is too low | Every variant’s valid weight and unit |
| A large first purchase bypasses the cumulative threshold | Add a single-order quantity rule |
| Refunded purchases still count | Counts do not automatically decrease on refunds |
| A product outside a collection is blocked | General rules or remaining in-scope cart items |
| A theme does not show a cart message | Verify actual checkout enforcement, then review cart presentation |

## If saving fails

Read the page’s error. Too many collections, tags or message content may prevent saving. Reduce unnecessary configuration and try again; do not rely only on the switch’s appearance.

For support, prepare the rule name, products, sign-in state, tags, cart quantities/amounts/weights, reproduction steps and actual message. Remove customer contact details and other personal information before sharing.

See [rule priority](https://order-limit.xrtotech.com/en/settings/rule-priority.md).

## What to include when contacting us

Open the bottom-right contact entry to show the WeChat QR code. Include the rule category, intended result, saved settings and one allowed and one blocked test. Remove personal information first. Use the [test record template](https://order-limit.xrtotech.com/en/getting-started/launch-checklist.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.