For the complete documentation index, see llms.txt. This page is also available as Markdown.

Volume tiers & case multiples

Reward bulk buyers with a lower per-unit price, and force products to be bought by the carton β€” plus the storefront blocks that explain both.

Two related quantity rules, configured on the same cell:

  • Volume tiers change the price as quantity climbs.

  • Case multiples restrict which quantities are allowed at all.

Use either alone, or both together.

Volume tiers

A tier is a minimum quantity and a value. The tier applies from its minimum quantity until the next tier takes over.

  • 1+ β†’ $10.00 each

  • 12+ β†’ $9.00 each

  • 24+ β†’ $7.00 each

A cart with 18 units pays $9.00 each. At 24 it drops to $7.00.

Tiers are per tag and per variant, so Wholesale and Distributor can have entirely different ladders on the same product.

The value means whatever the cell's discount type says β€” a price, a percentage off, or an amount off.

Setting them up

  1. Open the price list editor and find the product. Use filters if the catalog is large.

  2. Open the cell's settings for the tag you are pricing.

  3. Choose the discount mode β€” Specific price, Percentage or Fixed amount.

  4. Add tiers with Add tier, filling Min qty and the value field (Price, Unit % off or Unit amount off, depending on mode).

  5. Save.

Include a tier at quantity 1 if you want a price to apply below your first bulk break. Without one, small quantities get no pricing from this tag at all.

Case multiples

A case multiple forces the quantity to be a multiple of the case size. Set Case multiple to 12 and the buyer may order 12, 24, 36 β€” but not 10.

Enforcement happens at checkout: a cart that breaks the rule cannot complete. To tell the buyer before they reach checkout, add the Validation Message block to your product page (below).

A case multiple is valid on its own, with no pricing at all. That gives you carton-only ordering without any discount β€” a common requirement for products that physically ship by the case.

Showing tiers on the product page

Two theme app blocks make the rules visible. Both are added in Online Store β†’ Themes β†’ Customize, on your product template, via Add block β†’ Apps.

Volume Tiers

Renders the pricing ladder as a table for the signed-in customer's tag.

Setting
What it does
Default

Quantity label

Header of the quantity column

Quantity

Price label

Header of the price column

Price

Discount label

Header of the discount column

Discount

Quantity suffix

Appended to each quantity, e.g. 12+

+

Price suffix

Appended to each price, e.g. $9.00/ea

/ea

Discount suffix

Appended to each discount value

empty

Show discount

Whether to show the savings column at all

on

Discount type

Show savings as a fixed amount or a percentage

fixed

Single unit column label

Header for the loose-unit column, when loose pricing is in use

Single Unit

Hide price without login

Hide the table from logged-out visitors

on

Sign in message

Shown instead of the table when hidden

Sign in to see price

Hide App CSS

Drop our styles so yours can take over

off

CSS

Your own CSS for the block

β€”

Validation Message

Explains the case rule and warns when the quantity is invalid.

Setting
What it does
Default

Custom Validation Message

The message text, with variables

{productTitle} should be a multiple of {caseQuantity}

Hide without login

Hide the message from logged-out visitors

off

Sign in message

Shown instead when hidden

Please sign in to see validation messages

Available variables: {productTitle}, {variantTitle}, {caseQuantity}, {tagName}.

Bulk setup by CSV

For more than a handful of products, do this in the spreadsheet. Tiers and case multiples live in the same cell as the price:

That reads as: $10 each from 1, $9 from 12, $7 from 24, and quantities must be multiples of 12.

The full grammar β€” including percentages, fixed amounts and loose pricing β€” is in CSV import & export.

Common problems

The tier table is empty on the product page. The signed-in customer's tag has no pricing on that variant, or the price list is disabled. An untagged visitor sees the sign-in message instead.

Checkout rejects a quantity the buyer thinks is fine. A case multiple is set. Add the Validation Message block so the rule is visible on the product page, or switch to loose unit pricing if leftover units should be allowed.

Tiers show but the cart charges something else. Check for a second tag on the customer with a lower price β€” the lowest price wins.

Last updated