Skip to content
Esc

Start typing to search the docs.

On this page
Fix Updated Aug 16, 2026

Quantity picker not locked

Almost always because only checkout enforcement is configured. Locking the picker is a separate layer needing the app embed, the product metafield and the "Allow bulk limit" toggle — all three.

Applies to
  • Storefront quantity locking
  • 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

Storefront locking needs every one of these. Missing any means nothing happens.

RequirementCheck
Theme app embed enabledDashboard reads “App embed is active”
Product metafield setThe product carries the rule metafield with a type and value
Allow bulk limit onIn a rule, and the rule is enabled

Work through all three rather than re-checking one. The usual gap is the metafield — merchants configure the rule in the app and reasonably assume that is the whole job.

The theme has to be saved

Enabling the embed in an unsaved editor session does not count. Save the theme, then use Refresh status on the dashboard.

Some themes need pointing

Themes render quantity inputs differently. If all three requirements are met and one theme still ignores the lock, that is a theme-compatibility issue rather than a configuration one — the same selector settings used for cart-page messages are the place to start.

Verify the fix

  1. Product with the metafield → picker refuses invalid numbers.
  2. Product without it → picker behaves normally.
  3. Force an invalid quantity anyway → checkout still blocks.

Point 3 matters. The storefront lock is browser-side and bypassable; if checkout does not also block, you have no real enforcement.

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