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: go to Shopify Settings → Checkout → Checkout rules, open moq-validation, click Turn on, then Save.

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 — Shopify doesn't run cart validation functions there.

I want to pause enforcement temporarily#

Turn off the moq-validation rule in Shopify Settings → Checkout → Checkout rules, and turn it back on 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.