Quantity Break discounts reward customers for buying more — "Buy 3, get 10% off," "Buy 5, get $5 off each," or "Buy 10, get $20 off your order." GetSale builds the discount tiers, applies them automatically at checkout, and (optionally) shows a pricing table on your product pages so customers can see the savings before they add to cart.
This guide walks through building a Quantity Break discount from the amount type through storefront styling.
Before you start: plan availability
Quantity Break discounts are available on every GetSale plan. Two parts of the builder are gated to higher-tier plans:
Mix of products/variants condition (letting different products count toward the same tier) requires the Standard plan or higher.
Custom table design (colors, fonts, border radius, saved theme templates) also requires Standard or higher.
The number of tiers you can add per discount is capped at 5 on Free/Basic/Standard, and raised to 10 on the Unlimited plan.
If a control is locked, you'll see an upgrade prompt next to it — click through to Settings > Plans to compare tiers.
Step 1: Set the discount amount
From Discounts > Create discount > Quantity Break, the first section is Select Option, where you choose how the discount is calculated:
Option | What it does |
|---|---|
Percentage | Takes a percentage off the price of each qualifying item (0–99.99%, up to 2 decimal places). |
Fixed Amount Off Each Product | Subtracts a fixed amount from the price of every qualifying item in the cart. |
Fixed Amount Off Total | Subtracts a single fixed amount from the order subtotal once the quantity threshold is reached — it does not divide the amount across items. |
Important: Fixed Amount Off Total can only be used with the Mix of products/variants discount condition (see Step 3). If you select Fixed Amount Off Total while "Same product/variant" is selected, the condition option becomes disabled with the note "Not available with Fixed total off — a fixed total discount always applies once to the cart subtotal." This is because a fixed-total discount is applied as a single order-level deduction, not a per-line adjustment, so it can't be evaluated against one line's quantity in isolation.
Step 2: Build your tiers
Each tier is a pair of values:
Discount/Pricing — the percentage or amount to give
Minimum quantity of items — the quantity a customer needs to reach to unlock that tier
Click Add discount tier to add more rows, up to your plan's tier limit (5 or 10). For example:
Minimum quantity | Discount |
|---|---|
3 | 10% off |
5 | 15% off |
10 | 20% off |
How the highest qualifying tier is applied
Tiers don't stack, and order doesn't matter when you enter them — GetSale automatically evaluates them by quantity and applies only the single highest tier the customer currently qualifies for. In the example above, a customer with 7 qualifying items gets the 5-item tier (15% off), not the 3-item tier, and not a combination of both. Reach 10 items and the discount jumps to 20% off — it never adds tiers together.
This evaluation happens live in the cart and at checkout, so the discount automatically upgrades as the customer adds more qualifying items, with no code required.
Step 3: Discount conditions — mixing products vs. requiring the same product
The Discount Conditions section controls what counts toward a tier's quantity threshold:
Mix of products/variants (
productMix) — Any combination of qualifying products or variants in the cart counts toward the same running total. A customer buying 2 units of Product A and 3 units of Product B qualifies for the 5-item tier. Requires the Standard plan or higher.Same product/variant (
sameProduct) — Each product variant is evaluated on its own. A customer must add multiple units of the same variant to reach a tier; quantities of different variants are never combined. This is the default and is not available when the value type is Fixed Amount Off Total.
Pick "Mix of products/variants" for offers like "buy any 5 items from this collection," and "Same product/variant" for offers like "buy 3 of the same t-shirt, save 10%."
Step 4: Targeting and excluding products
Choose exactly one targeting method for the discount:
Individual products/variants
Collections
Product tags — applies to all products carrying at least one of the selected tags
Vendors — applies to all products from the selected vendors
Whole store
Draft and archived products are included in targeting automatically.
Optionally, add one exclusion type (products, collections, tags, or vendors) to carve out items that shouldn't count toward the discount even though they match your target. You can't combine two target types or two exclusion types on a single Quantity Break discount — if you need more complex logic, create a second discount.
Step 5: Customize the storefront widget
The optional pricing table shown on product pages is configured in the widget section:
Content
Heading — e.g., "Buy more, save more!"
Description (optional) — supporting text shown under the heading
Quantity Text — supports the
{{product_quantity}}merge tag, e.g. "Buy {{product_quantity}}"Quantity Heading / Discount Value Heading — column headers for the table (default "Buy" / "Save")
Text Customization — the line shown for each tier's savings, using the
{{discount}}merge tag. The field shown here automatically matches your value type:percentageText("Get {{discount}}% off"),fixedAmountText("Get {{discount}} off each"), orfixedTotalText("Get {{discount}} off total")Show currency code for fixed amount discounts — appends the currency code (e.g., USD, EUR) next to fixed amounts
Table design (Standard plan and higher)
Click Customize Table to open color pickers for background, header, border, table text, and header text, plus font-size sliders for the title and table text and a border-radius slider.
Theme Templates — search and apply a design you've saved previously, so you don't have to restyle the table on every new discount.
Default Theme — resets colors and sizing to GetSale's defaults.
Save as template — saves your current color/font/radius combination as a reusable template. The save button is disabled until you change a color or font size (or unless you've just picked a template with no further edits).
Placement (Advanced settings)
Click Advanced settings to control exactly where on the page the table is injected:
JS Selector — a CSS selector identifying the element the widget anchors to. Defaults to
form[action*="/cart/add"] button[type="submit"](your Add to Cart button); click Reset to restore the default if you've customized it and want to start over.Placement — Above or Below that element.
Turning on the storefront widget
The widget only renders if the GetSale Quantity Breaks app embed is active in your theme, and only on product pages. If the embed is off, you'll see a banner reading "Activate the GetSale App Embed in your theme to show the widget on your store" with a button to jump straight to the theme editor. If a discount is scheduled for the future or has already ended, the widget won't display even with the embed active.
Step 6: Combinations with other discounts
In the Combinations section, choose whether this Quantity Break discount can combine with other active discounts:
Do not Combine — the discount won't apply alongside any other discount.
Combine — check any of Order Discounts, Product Discounts, and Shipping Discounts to allow this Quantity Break to stack with discounts in those classes, subject to Shopify's own combination rules.
Shopify enforces its own limits on which discount classes can combine regardless of what you select here — review Shopify's discount combination documentation if a combination isn't behaving as expected.
Publishing the discount
Set a schedule (activate immediately or schedule a future start/end), then save. Once the discount is active, GetSale creates the underlying Shopify automatic discount and — if you've configured a widget — the storefront metadata needed to render the pricing table. You can edit the widget's content and design at any time while the discount is live; other settings (amount, tiers, conditions, targeting, schedule) can only be changed while the discount is inactive or scheduled.
Troubleshooting & FAQ
Why isn't the pricing table showing on my product page? Confirm the GetSale Quantity Breaks app embed is turned on in Online Store > Themes > Customize > App embeds, and that you're viewing a product page (the widget doesn't render anywhere else). Also check the discount's schedule — a scheduled-but-not-yet-started or already-ended discount won't render its widget even with the embed active.
A customer has enough items, but the biggest discount isn't applying. Check your discount condition. Under "Same product/variant," quantities of different variants are never added together — a customer needs multiples of one specific variant to hit a tier. Switch to "Mix of products/variants" if you want quantities across different products to count toward the same tier (Standard plan or higher).
I can't select Fixed Amount Off Total with "Same product/variant." This combination isn't supported — a fixed-total discount is applied once to the order subtotal, so it can't be evaluated per line/variant. Switch the condition to "Mix of products/variants," or change the value type to Percentage or Fixed Amount Off Each Product.
Why can't I add more than 5 tiers? Your plan caps the number of tiers per Quantity Break discount at 5. Upgrade to the Unlimited plan to add up to 10 tiers on a single discount.
Why is the "Mix of products/variants" option or "Customize Table" locked? Both require the Standard plan or higher. You'll see an upgrade prompt — visit Settings > Plans to upgrade.
Can I combine a Quantity Break with a discount code? Only if you enable Combine and check the matching discount class, and only within Shopify's own combination limits. Automatic discounts (like Quantity Break) can never combine with a discount code that shares the same discount class as another already applied automatic discount — see Shopify's documentation linked above for the full rules.