Storefront Widget

The storefront widget is an optional add-on that shows quantity requirements to customers before they reach checkout. It uses Shopify's Theme App Extension system — it doesn't modify your theme files and can be removed at any time.

The widget has two independent blocks. You can use one, both, or neither.

Product Page Badge#

Displays quantity requirements directly on your product page, before the customer has added anything to their cart.

• Shows minimum, maximum, and/or step quantity requirements in a compact badge
• Only appears on products that have an active rule — invisible on all other products
• Works with product-targeted and collection-targeted rules
• Place the block wherever makes sense — typically below the quantity selector

Example display:

Minimum order: 12 units · Maximum order: 48 units · Order in multiples of: 6

Cart Validator#

Shows a warning on your cart page when a customer's current quantities would fail at checkout.

• Checks all cart items against your rules using the Shopify Cart Ajax API
• Displays a summary of violations above the checkout button
• Updates automatically when the customer changes quantities
• Hides itself when all quantities are valid — no visual noise when everything is fine

Example display:

⚠️ Please review your quantities before checkout:
  Ceramic Mug (Set of 4)
  • Minimum is 6 — you have 4
  • Must be a multiple of 6 — nearest valid quantity is 6

Installing the Widget#

The widget is added through your theme's customiser — no code changes required.

1. In your Shopify admin, go to Online Store → Themes
2. Click Customize on your active theme

To add the Product Page Badge:

1. Navigate to a Product page template in the customiser
2. Click Add block and select MOQ Product Badge
3. Drag the block below your quantity input
4. Click Save

To add the Cart Validator:

1. Navigate to the Cart page template in the customiser
2. Click Add block and select MOQ Cart Validator
3. Place the block above your checkout button
4. Click Save

Limitations#

The storefront widget is designed to be a helpful preview — checkout enforcement is always the authoritative check.

• Cart Validator — collection rules: The cart page warning only shows for product-targeted rules. Collection rules cannot be matched on the cart page because the Shopify Cart Ajax API does not expose which collections a product belongs to. Checkout enforcement will still catch any collection-targeted violations.
• Variant rules: Rules targeting specific variants are not shown in the product badge or cart validator. Checkout enforcement still applies.