Skip to content
Esc

Start typing to search the docs.

On this page
Fix Updated Aug 16, 2026

Quantity picker not locked

If checkout is blocking invalid quantities but the quantity picker is still not restricted, the storefront quantity lock is probably not fully set up. Make sure the app embed is enabled, the product has the required metafield, and "Allow bulk limit" is turned on.

Applies to
  • Quantity locking on product and storefront pages
  • Premium plan
Doesn't apply to
  • Checkout blocking, which works independently
Not sure how the two layers differ? Read this first

All three are required

For the quantity picker to follow your product quantity limit, all three requirements below must be set up.

RequirementHow to check
Theme app embed is enabledOn the Nex Validator dashboard, confirm it says “App embed is active”
Product metafield is setOpen the product and confirm the Checkout Rule metafield has the correct JSON value — see Product bulk limit
Allow bulk limit is turned onOpen the rule, turn on Allow bulk limit, make sure the rule is enabled, and save

Check all three requirements one by one. A common missing step is the product metafield. Creating the rule in Nex Validator alone does not automatically lock the product-page quantity selector.

The theme has to be saved

After enabling the Nex Validator app embed in the Shopify Theme Editor, click Save. Then return to the Nex Validator dashboard and click Refresh status.

Some themes need extra setup

Shopify themes can display quantity selectors differently. If all three requirements are correct but the quantity picker still does not lock, your theme may need additional selector configuration. Check the selector settings used by Nex Validator, or contact support if you are not sure which selector to use.

Verify the fix

  1. Open a product that has the quantity metafield. Try an invalid quantity. The quantity picker should prevent it.
  2. Open a product without the metafield. Its quantity picker should continue to work normally.
  3. Test checkout with an invalid quantity. Checkout should still block the order according to your enabled rule.

Frequently asked

I set a Product Min Quantity rule. Why is the picker unchanged?

That rule enforces at checkout only. It does not drive the storefront picker — the metafield does.

Is this broken?

Almost certainly not. Checkout enforcement working while the picker does not is the default configuration, not a fault.

See also: Lock the quantity selector · How enforcement works · Install and enable the app embed