Liftly Quantity Breaks guide
From installing the app to showing the breaks on your product page, step by step.
Install the app
- Open Liftly Quantity Breaks in the Shopify App Store and click Install.
- Shopify shows what the app may access: your discounts, so it can create and update the automatic discounts that carry your offers, and your products, so you can pick products and collections. Approve the installation.
- The app opens inside your Shopify admin. The setup guide on its home screen walks you through the next two sections.
Create your first offer
An offer is a set of quantity breaks, for example “buy 2 save 10%, buy 3 save 15%, buy 5 save 20%”, together with the products it applies to.
- On the app’s home screen click Create offer.
- Give it an Offer name. Only you see this name, in the offers list and in Shopify discounts.
- Under Products choose All products, Specific products or Collections. An offer can cover up to 250 picked items; use a collection for more.
- Under Quantity breaks set, for each break, the Quantity it starts from (2 or more), the Discount type and its Value. Click Add break for the next one. An offer can have up to 10 breaks, and each higher break has to be a better deal than the one before it.
- Optional: give a break an Option name such as “Family pack” to replace the default “Buy 3+”, and a Ribbon such as “Most popular”.
- Leave Show the single item row on if you want shoppers to compare every break with the regular price for one item.
- Under Texts set the heading shoppers see on the product page and the discount name they see in the cart and at checkout.
- Save. The discount starts working as soon as you save: add two items of a product from the offer to your cart and the lower price is already there.
Each offer is a native Shopify automatic discount, so you will also find it under Discounts in your Shopify admin. Change it in the app to keep the product-page block and the discount in step.
Add the block to your product page
The discount works without it, but the Quantity breaks block is what shows shoppers the options before they add to cart. It is a theme app block: nothing in your theme code is edited.
The quick way
- In the app’s setup guide click Open theme editor. The editor opens on your product page with the block already placed.
- Drag the block where you want it. Just above the buy buttons works well.
- Click Save in the theme editor.
By hand, in the theme editor
- In your Shopify admin go to Online Store → Themes and click Customize on your theme.
- In the page selector at the top choose Products and the product template you use.
- In the product information section click Add block, open the Apps tab and choose Quantity breaks.
- Drag it into place and click Save.
Block settings
| Setting | What it does |
|---|---|
| Heading | The line above the options. Leave it empty to use the heading saved with the offer. |
| Layout | Stacked cards, Side by side (a grid) or Compact list. |
| Show savings badge | The “Save 15%” pill next to each break. |
| Show total and savings line | The live line under the options: “Total for 3: $61.20 · You save $10.80”. |
| Accent color, Text color, Card background | Match the block to your theme. |
| Corner radius | From square corners to fully rounded cards. |
| Space above, Space below | The gap between the block and its neighbours. |
When a shopper chooses an option, the block sets the quantity on the product form. When they change the quantity themselves, the matching option is highlighted.
If your store uses more than one product template, add the block to each template you want it on. In the theme editor, products that are not part of an active offer show a short placeholder instead of the options; shoppers never see it.
Discount types
Every break has its own type. The examples use a product that sells for $24.00 and a break that starts at 3 items.
| Type | You enter | Each item | Three items |
|---|---|---|---|
| Percent off each | 15 | $20.40 | $61.20 |
| Amount off each | 3.00 | $21.00 | $63.00 |
| Fixed price each | 20.00 | $20.00 | $60.00 |
- A break applies to every item once the quantity reaches it, not only to the extra ones.
- Between two breaks the lower one applies: with breaks at 3 and 5, a shopper who buys 4 gets the “3+” price on all four.
- The savings badge always shows a percentage. For amount and fixed price breaks the app works it out from the product’s price.
- Gift cards are not discounted.
How quantity is counted
Under How quantity is counted you decide what adds up towards a break. Take a T-shirt in red and blue, a break at 3 items, and a cart with 2 red and 1 blue.
| Mode | What counts together | In the example |
|---|---|---|
| Per product | All variants of one product. | 2 red + 1 blue = 3. The break applies to all three. |
| Per variant | Each variant on its own. | Red counts 2, blue counts 1. Neither reaches 3. |
| Mix and match | Everything in the offer. | The 3 shirts count together, and so would 2 shirts + 1 cap from the same offer. |
With mix and match the block adds the line “Mix and match with other items in this offer”, so shoppers know they can combine products.
Scheduling
Under Schedule set a Start date, an End date or both. Dates use your store’s time zone. Leave them empty and the offer runs with no end.
- Before the start date the offer is listed as Scheduled. The discount and the block switch on at the start.
- At the end date both switch off on their own. Orders already placed keep their prices.
- You can also stop or restart any offer by hand with Turn off and Turn on in the offers list.
Setting up a weekend sale? Create the offer on Monday with Friday as the start date and Sunday night as the end date, and it runs itself.
Combining with other discounts
Volume prices are applied by Shopify itself, through Shopify Functions, in the cart, at checkout and in accelerated checkouts such as Shop Pay. Shoppers never enter a code. Here is how they sit next to your other promotions:
| Other discount | What happens |
|---|---|
| Order discount | Combines. A code for 10% off the order is applied on top of the volume price. |
| Shipping discount | Combines. |
| Another product discount on the same item | Does not stack. Shopify keeps the better one for the shopper. |
Discounts from Shopify Functions also run on Shopify POS. The product-page block is an online store feature.
Currencies and Markets
- The app works with every currency of Shopify Markets.
- Percent breaks are the same in every currency.
- Amount and fixed price breaks are entered in your store currency and converted with your store’s rate for shoppers who pay in another one.
- The block shows amounts in the shopper’s currency, in your store’s money format.
- Right-to-left languages, keyboard navigation and screen readers are supported.
Troubleshooting
The block does not show on a product
The block appears only on products that are part of a live offer. Check these five things, in this order:
- The offer is not active. Open the app: the offer’s status has to be Active. If it says Off, click Turn on.
- The product is not in the offer. Open the offer and look at Products: the product has to be picked, or belong to one of the picked collections.
- The block is not on this template. Open the product in the theme editor and check that Quantity breaks is in the product information section of the template this product uses.
- The customer is not tagged. If the offer has customer tags, only signed-in customers with one of those tags see it. Sign in as a tagged customer to test.
- The offer is scheduled. An offer with a start date in the future, or an end date in the past, does not show. Check the dates under Schedule.
The discount is in the cart but the options are not on the product page
The discount works as soon as an offer is saved; the options need the block. See Add the block to your product page.
A code and the volume price do not add up
Order and shipping discounts combine with volume prices. Another product discount on the same item does not: Shopify keeps the better one. See Combining with other discounts.
Still stuck? Write to us. We answer every message, usually within one business day.
Uninstalling
- In your Shopify admin go to Settings → Apps and sales channels.
- Find Liftly Quantity Breaks and click Uninstall.
Shopify removes the offers and the block together with the app. Your settings lived in your own store, as Shopify discounts and metafields, so nothing is left behind in your theme code. Orders already placed keep their prices.