Skip to content
Esc

Start typing to search the docs.

On this page
Fix Updated Aug 16, 2026

Troubleshooting

Most reports come down to one of three things: the rule is not enabled, the app embed is off, or you are expecting the storefront layer to work when only checkout is configured.

Applies to
  • All Shopify plans
Doesn't apply to

No exclusions.

Find your symptom

What you seeGo to
Checkout completes when it should be blockedLimit is not blocking checkout
No message appears when blockedMessage not showing
The quantity picker still allows any numberQuantity picker not locked
Dashboard says the embed is off after enabling itApp embed not active
A rule will not save or enableRule will not save
Blocked at checkout but nothing on the cart pageWorks at checkout but not in cart
Fine for you, broken for customersWorks for me but not for customers

The two checks worth doing first

Is the rule enabled? A saved rule is not a live rule. This is the single most common cause.

Is the app embed active? Checkout blocking works without it; storefront quantity locking and cart-page messages do not. Half of all reports are one of those two layers being expected without the embed.

If both are fine, pick your symptom above.

Frequently asked

Where do I start?

Confirm the rule status is enabled and the app embed is active. Those two account for most reports before anything subtler is worth investigating.

It works for me but not for a customer.

Their cart, currency or language differs from your test in a way the rule depends on. See that page for the differences worth checking.

See also: Limit is not blocking checkout · Quantity picker not locked · How enforcement works