Quantity rules

Set a pack size

A pack size means a product must be ordered in multiples of a number, for example 6, 12, 18. With a pack size of 6, the quantity selector moves in steps of 6. It's also called a quantity increment.

Every quantity rule is set on the product variant, even when the product has a single variant. To give all of a product's variants the same rule, enter it on each one, or use the bulk editor.

Set minimum and maximum quantities

Minimum and maximum quantities stop customers ordering too few or too many units. Each one has its own field, and they work the same way as the pack size:

1. Turn on the field for your rule. On Shopify, go to Integrations,Platform (opens in your SparkLayer Dashboard in a new tab)Opens in your SparkLayer DashboardTakes you straight to Integrations › Platform to do this now, whichever platform you're on. Opens in a new tab. and, in the Metafields card, click Configure next to SparkLayer metafields. On other platforms, add it first using the metafield reference, then enable it there.
2. On each variant, enter a whole number, for example 6, 12 or 20. Product-wide rules are still entered on each variant.
3. Save the product.

What customers see

When a product has a quantity rule, the product interfaces apply it as customers build their order:

• The quantity selector follows the rule. If a customer types a quantity that doesn't fit the pack size, it updates to fit.
• A Qty rules apply link appears under the quantity selector. It opens the rule, such as "This product comes in pack sizes of 6".
• With a pack size, a pack price shows under the unit price, for example Pack (6): US$71.40.

Show or hide the pack price

The pack price is the unit price multiplied by the number of items in a pack. It shows in the product detail interface.

To hide the pack price, you or your developer add this line to your custom CSS:

--spark-pdp-pack-size: none;

To change the pack price wording without code, add a translation override for the key pdp.price.pack-size at Storefront,Options,Translation overrides (opens in your SparkLayer Dashboard in a new tab)Opens in your SparkLayer DashboardTakes you straight to Storefront › Options › Translation overrides to do this now, whichever platform you're on. Opens in a new tab.. In the text, {packSize} is the pack size and {price} the pack price.

translations: {
  en: {
   "pdp.price.pack-size": "Pack ({packSize}): {price}",
  }
},

<!-- SparkLayer Core Script: in your theme, just before </head>.
     Already have window.sparkOptions? Add just the setting to it. -->
<script>
  window.sparkOptions = {
    translations: {
      en: {
       "pdp.price.pack-size": "Pack ({packSize}): {price}",
      }
    },
  };
</script>

Hide the "Qty rules apply" message

To hide the link, you or your developer add this line to your custom CSS:

--spark-product-qty-rules-display: none;

Set order limits

Order limits apply to the whole order rather than to one product, and customers can't check out until their order meets them. They're rules on a customer group, so they don't need metafields. There are two:

To set them:

1. Go to Customers,Groups (opens in your SparkLayer Dashboard in a new tab)Opens in your SparkLayer DashboardTakes you straight to Customers › Groups to do this now, whichever platform you're on. Opens in a new tab. and click a group's name (or Edit on the base customer group, for every group).
2. Under Inherited rules, click + Override next to Order total limits or Order quantity limits (on the base group, + Customize).
3. For Order total limits, choose a Currency and enter a Minimum order total and, if you want one, a Maximum (optional). To set a limit in another currency, click Add order total limit. To remove one, click the bin icon next to it. For Order quantity limits, click Configure.
4. Click Save.

When a customer's order doesn't meet a limit, the My Cart shows a message such as "Your order must be more than $100 to meet the order requirements" and Checkout is unavailable until they change their order.

Change the order limit messages

To change the wording without code, add a translation override for the message's key, shown below, at Storefront,Options,Translation overrides (opens in your SparkLayer Dashboard in a new tab)Opens in your SparkLayer DashboardTakes you straight to Storefront › Options › Translation overrides to do this now, whichever platform you're on. Opens in a new tab.. See Languages and international. In the text, {amount} is the order total limit, and {minimum} and {maximum} the number of items.

translations: {
  en: {
    "cart.validation-message.minimum-order-totals": "Your order must be more than {amount} to meet the order requirements.",
    "cart.validation-message.maximum-order-totals": "Your order must be less than {amount} to meet the order requirements.",
  }
},

<!-- SparkLayer Core Script: in your theme, just before </head>.
     Already have window.sparkOptions? Add just the setting to it. -->
<script>
  window.sparkOptions = {
    translations: {
      en: {
        "cart.validation-message.minimum-order-totals": "Your order must be more than {amount} to meet the order requirements.",
        "cart.validation-message.maximum-order-totals": "Your order must be less than {amount} to meet the order requirements.",
      }
    },
  };
</script>

translations: {
  en: {
    "cart.validation-message.minimum-order-item-quantity": "Your order must have at least {minimum} items to meet the order requirements.",
    "cart.validation-message.maximum-order-item-quantity": "Your order must not exceed {maximum} items to meet the order requirements.",
  }
},

<!-- SparkLayer Core Script: in your theme, just before </head>.
     Already have window.sparkOptions? Add just the setting to it. -->
<script>
  window.sparkOptions = {
    translations: {
      en: {
        "cart.validation-message.minimum-order-item-quantity": "Your order must have at least {minimum} items to meet the order requirements.",
        "cart.validation-message.maximum-order-item-quantity": "Your order must not exceed {maximum} items to meet the order requirements.",
      }
    },
  };
</script>

Quantity pricing (tiered pricing)

Quantity pricing gives lower unit prices for larger quantities, for example buy 1 for $10 or 10 for $8. See Quantity pricing and settings.

Quantity pricing sets a minimum too: the lowest quantity tier in the customer's price list is the smallest quantity they can order. If a product's first tier is 50+, customers see "Unavailable in selected quantity" below 50. To let them order fewer, add a price from a quantity of 1.

Unit of measure pricing

Unit of measure pricing sets prices for units such as boxes, cartons or pallets. See unit of measure pricing.

Set different rules for each customer group

Everything above applies to all your B2B customers. To give a customer group its own pack size, minimum or maximum, use the sparklayer.settings field on the variant (product settings). For example, most customers could buy in packs of 6 and a tier-2 group in packs of 12.

1. Find each group's handle: open the group at Customers,Groups (opens in your SparkLayer Dashboard in a new tab)Opens in your SparkLayer DashboardTakes you straight to Customers › Groups to do this now, whichever platform you're on. Opens in a new tab. and look under Handle (or ID).
2. In the form below, enter each group's handle and its rules. It writes the value for you. Use base for the rules everyone else gets.
3. Click Copy, paste the value into the variant's sparklayer.settings field and save. To give many variants the same rules, paste it into each row in Shopify's bulk editor.

See Product rules per customer group for everything this field can do.

Which rule wins

SparkLayer uses the first of these that applies to the customer:

1. The customer's group entry in sparklayer.settings. It overrides the base entry for that group.
2. The base entry in sparklayer.settings. It's the default for every customer group.
3. The individual fields, such as sparklayer.pack_size and sparklayer.max_order_quantity, but only when the variant has no sparklayer.settings value.

For example:

[
  { "customer_group": "base", "pack_size": 50 },
  { "customer_group": "retail-partners", "pack_size": 10, "display": true },
  { "customer_group": "distributors", "display": false }
]

Every group buys in packs of 50, except retail-partners, who buy in packs of 10. distributors don't see the product. A sparklayer.pack_size on the same variant is ignored. See Product rules per customer group.

Metafield reference

This reference is for whoever sets up your product data. All keys use the namespace sparklayer and are set on product variants. On Shopify, the custom data type is Variants (opens in a new tab). On other platforms, use variant-level product fields.

Troubleshooting

FAQs