Troubleshooting MOQ Manager

The issues merchants actually hit, roughly in order of frequency, with fixes.

Rules aren't being enforced at checkout#

Nine times out of ten this is the Shopify validation rule still switched off:

1. Open the app's App Setup page. Step 2 must show complete.
2. If not: click Activate Now right there on the Settings page. Enforcement normally activates itself on install, so this is rare.

This is a one-time activation Shopify requires merchants to do themselves: the app can't flip it for you. Full walkthrough in Getting Started.

A specific product isn't validating#

• Confirm the product is actually targeted: open the rule and check its Restricted Items.
• Collection rules: check the product is still in the collection. Products removed from a collection stop being covered.
• Variant rules only count that variant: 10 units of a different variant won't satisfy a variant rule. See Rule Types.

The customer sees two error messages at once#

Working as designed: rules are evaluated independently, so a product covered by both a product rule and a collection rule can fail both. If that's noisy, consolidate. One scope per product is usually enough.

The storefront badge isn't showing#

• The badge block must be added in the theme editor (Online Store > Themes > Customize > product template > MOQ Product Badge).
• The badge only appears on products with an active rule: it's invisible everywhere else.
• Variant rules aren't shown in the badge or cart validator (checkout still enforces them). Same for collection rules on the cart page: the cart API doesn't expose collections. See Storefront Widget.

"This rule would exceed your plan limit"#

Your rules' combined coverage exceeds the plan's product limit (Free 3 · Standard 10 · Pro 50 · Unlimited ∞). Collection rules count every product in the collection, up to 250 per collection. Trim the rule or upgrade; see Plans & Billing.

Draft orders and POS ignore my rules#

Expected: the Cart Validation Function applies to online checkout only. Draft orders and Shopify POS bypass it by design, because Shopify doesn't run cart validation functions there.

I want to pause enforcement temporarily#

Deactivate the Minimum Order Quantity Manager configuration in Shopify Settings > Checkout, and reactivate from the app's Settings page when ready. Your rules in the app stay saved.

Still stuck?#

Email info@lubbelabs.com with your store URL, the rule setup, and what the customer saw. We usually reply within one business day.