Skip to main content

Minimum Quantity Feature Setup Guide

Overview​

The Maker theme supports a minimum quantity feature that allows merchants to set a per-product minimum purchase quantity. When a minimum quantity is set, customers must purchase at least that many items of the product.

Metafield Setup​

To enable minimum quantity for a product, you need to create a product metafield:

Step 1: Create the Metafield Definition​

  1. In your Shopify admin, go to Settings → Custom data
  2. Click the Products tab
  3. Click Add definition
  4. Fill in the following:
    • Name: Minimum Quantity
    • Namespace and key: custom.minimum_quantity
    • Type: Integer (whole number)
    • Description (optional): "Minimum quantity required for purchase"
  5. Click Save

Step 2: Set Minimum Quantity for Products​

  1. Go to Products in your Shopify admin
  2. Select a product
  3. Scroll down to the Metafields section
  4. Find the Minimum Quantity field
  5. Enter the minimum quantity (e.g., 3 for a minimum of 3 items)
  6. Click Save

How It Works​

  • Product Page: When a minimum quantity is set, the quantity selector will automatically default to the minimum value
  • Validation: Customers cannot decrease the quantity below the minimum
  • Error Messages: If a customer tries to add to cart with less than the minimum, they'll see an error message
  • Cart Page: The minimum quantity is also enforced on the cart page
  • Price Display: A small informational note appears near the product price indicating the minimum purchase requirement

Priority​

The custom minimum quantity (metafield) takes precedence over Shopify's built-in quantity rules (variant.quantity_rule.min). If both are set, the higher value will be used.

Notes​

  • The minimum quantity must be a positive integer
  • This feature works alongside Shopify's quantity increment and maximum quantity rules
  • The minimum quantity applies to all variants of a product (it's set at the product level, not variant level)