Volume discount
Updated Nov 19, 20264 min read
On this page (6)
Offer percentage discounts, amount discounts or a total price for complete packs. Pack labels can split cart and checkout rows; large quantities may be summarized.
Set it up
- Click Create offer on the Offers page.
- Click Choose on Volume discount · Tiles or Stacked volume discount.
- Under Applies to, choose the products or collections that get the discount and show the block, or All products.
- For specific products, click the pencil icon beside a product in Applies to to choose eligible variants. Select every variant in the picker to remove a restriction.
- Set a different whole-number Quantity from 1 to 1,000 for each row under Quantity breaks. Choose a Discount and enter its value.
- Click Add quantity break for another row.
- Enter a Name, then click Save. Finish as in Create your first offer.
| Discount | Value to enter | How it applies |
|---|---|---|
| Percentage off | Percentage | Discounts all eligible units when the quantity is reached |
| Amount off | Amount to subtract | Comes off once per product |
| Set price | Total price for [quantity] items | Repeats for complete packs; leftovers keep their regular price |
The starting breaks are 1 at 0%, 2 at 10% and 3 at 15%. A 0% break shows regular price.
What you can change
| Change | Where | Current behavior |
|---|---|---|
| Quantities and discounts | Quantity breaks | Options appear in quantity order. The starting breaks preselect 2; there is no default-option setting |
| Tiles or Stacked list | Storefront style, on Offer | Both use the same quantities and discounts |
| Colors, corners, spacing and width | Design | See Customize the design for controls and ranges |
| Labels and translations | Text & translations | See Change the block’s text and translations for fields, defaults and limits |
| Individual elements | Advanced > Custom CSS | See Style bundles with CSS for Tiles/Stacked differences |
| Placement and add-to-cart buttons | Blocks > Placement | Use Only the theme's button to add the selected quantity through your theme's button |
| Product price and quantity beside the block | Custom integration | No built-in two-way synchronization or public selection getter/setter |
| Mixing variants | No setting | Eligible variants of one product can mix. With multiple eligible variants in stock, quantities of 2 or more open a picker with one row per unit |
| Variant eligibility | Pencil icon beside each product in Applies to | Only selected variants count and receive discounts. Excluded variants hide the offer and remain available at regular price. Selecting every variant removes the restriction and includes future variants |
| Displayed prices | Selected product variant | Each option shows its quantity's total. Crossed-out prices use the regular selling price times quantity, not Shopify's compare-at price |
Example
For $20 items, set 3 for $50 and 5 for $75:
| Eligible quantity of one product | Lowest total |
|---|---|
| 4 | $70: one 3-pack + one regular item |
| 6 | $95: one 5-pack + one regular item |
| 7 | $115: one 5-pack + two regular items |
| 8 | $125: one 3-pack + one 5-pack |
| 10 | $150: two 5-packs |
Each product counts separately. Hype chooses the lowest total across pack combinations and regular-price leftovers, or a qualifying percentage/amount discount. These alternatives do not stack within the offer. Packs never increase the regular total.
Customize with code
Under Offer > Advanced, copy CSS class and replace .hype-offer-YOUR_OFFER_ID below. Paste into Custom JS in the Hype: Bundlesapp embed, without <script> tags, to log option changes:
(() => { const selector = '.hype-offer-YOUR_OFFER_ID'; document.addEventListener('hype-v2:tier-change', (event) => { const block = event.target; if (!(block instanceof Element) || !block.matches(selector)) return; const { tier, index } = event.detail; console.log({ index, quantity: tier.quantity, total: tier.priceCents }); });})();Both styles expose:
| Hook | Meaning and limits |
|---|---|
hype-volume-tiles, hype-volume-stack | Element names for the two styles |
.hype-offer-YOUR_OFFER_ID, [data-hype-offer-id="YOUR_OFFER_ID"] | Target one offer; .hype-block targets every Hype block |
hype-v2:tier-change | Fires when a different option is selected. Does not fire on initial load, selecting the same option or variant repricing |
hype-v2:add-volume | An add request, not confirmation that the cart changed. Do not add the items again in a listener |
block.requestAdd() | Requests the current selection. Returns false when unavailable, busy or without a tier; true means a request was emitted, not that it succeeded |
cta-state | Cart feedback: busy, added, error, then idle; may be absent before the first request |
cta="none" | The block's button is absent. Configure buttons through Placement, rather than setting this attribute yourself |
| Initial selection and repricing | No event for either; the events above alone cannot keep theme prices and quantity synchronized |
| Missing option content | CSS cannot add missing dynamic prices inside options |
Both events bubble to document; event.target is the block. Their event.detail contains:
| Value | Meaning |
|---|---|
index | Zero-based option index, in quantity order |
tier.quantity | Number of units |
tier.unitLabel | Singular/plural item label |
tier.priceCents | Discounted total in the shopper's currency, in minor units; already currency-converted |
tier.compareAtCents | Optional regular selling total before the volume discount; absent when there is no saving |
tier.saveBadge | Optional percentage-savings text; absent for amount-off tiers and offers containing Set price |
Good to know
- To customize Amount off or Set price by market, see Sell in specific markets.
- To combine this offer with other discounts, tick the types under Combinations. Both discounts must allow each other's type.
- A volume discount doesn't apply to bundles in the cart.
- Each active volume discount uses one of Shopify's 25 automatic discounts. See Bundles FAQ.
Related
Was this article helpful?
Related articles
Still stuck?
Ask a follow-up and we'll see it came from “Volume discount”.
Opens chat with your question and a link to this article.