Skip to content
Esc

Start typing to search the docs.

On this page
Reference Updated Aug 16, 2026

How enforcement works

Checkout blocking works as soon as a rule is enabled. Locking the quantity picker on your storefront is a separate layer that needs the app embed, a product metafield and the "Allow bulk limit" toggle. Neither depends on the other.

Applies to
  • All Shopify plans for checkout blocking
  • Premium, for the metafield-driven storefront layer
Doesn't apply to
  • Shopify POS
Just want to lock the quantity picker? Go straight to the how-to

Nex Validator enforces a limit in two places, and they are separate systems with separate switches. Almost every “why isn’t this working?” traces back to expecting one to imply the other.

Checkout blocking is automatic. The storefront lock is not.

Checkout — the layer that always works

Enable a rule and checkout enforcement is live. If the cart breaks the limit, payment is blocked and your message is shown.

This runs as a Shopify Function inside checkout, so it cannot be skipped by going direct to checkout, and it covers Shop Pay, express checkout buttons and direct checkout links.

This is the layer that actually protects you. Everything else is convenience.

Storefront — the layer you have to turn on

The theme extension can set min, max and step on the quantity input, so an invalid number cannot be picked. Three things must all be true:

  1. The theme app embed is enabled — see install
  2. The product carries the rule metafield
  3. Allow bulk limit is on in a rule

What this means in practice

You configuredStorefront pickerCheckout
Product Min Quantity rule onlyUnchangedBlocked
Metafield only, “Allow bulk limit” offUnchangedDepends on your rules
Metafield + embed + “Allow bulk limit” onLockedBlocked

The first row is the common surprise. A merchant sets a minimum of 6, sees the product page still allows 1, and concludes the rule is broken. It is not — it is enforcing at checkout exactly as configured.

Which layers you actually want

Checkout blocking alone is correct and safe. Adding the storefront lock is a conversion decision, not a safety one: it stops a customer building a cart they cannot buy, which is a better experience than a rejection at the payment step.

Never rely on the storefront layer alone. It runs in the browser and can be bypassed; the checkout layer cannot.

Next

Lock the quantity selector on your storefront.

Frequently asked

Why does my product minimum not change the quantity picker?

Because those are different layers. A Product Min Quantity rule enforces at checkout only. Locking the picker needs the product metafield plus the app embed plus "Allow bulk limit".

Do I need both layers?

No. Checkout blocking alone is correct and safe. The storefront lock is a usability improvement — it stops customers building an invalid cart in the first place.

Can the storefront layer be bypassed?

Yes, it is browser-side. That is exactly why checkout blocking exists underneath it and cannot be skipped.

See also: Lock the quantity selector · Product bulk limit · Install and enable the app embed