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

Create a product discount

Build automatic product-level discounts for buy-x-get-y, mix-and-match, bundles, and quantity tiers.

Use a product discount when only specific items should change price.

This is the right fit for bundle offers, mix-and-match offers, and product-led upsells.

What a product discount changes

A product discount applies to eligible line items.

It does not discount the whole order.

Use it when the rule depends on:

  • specific products or variants

  • a product combination such as Buy X Get Y off

  • quantity-based tiers on eligible items

Choose the right condition

Use Buy X Get Y off when one product unlocks a discount on another.

Use Buy A+B+C Get Y Off when shoppers must add a specific mix.

Use Bundle Discount when a set of products should work as one offer.

Before you start

Decide these four things first:

  • which products should qualify

  • whether the offer is for one-time purchases, subscriptions, or both

  • whether the discount should stack with other Roadmap product discounts

  • whether larger quantities should unlock stronger pricing

Create the product discount

1

Open the discounts dashboard

Go to Discounts / Gift with Purchase.

Create a new discount and choose Product Discount.

2

Add the internal setup details

Enter a clear Name.

Set the Status to Active when you are ready to run it.

3

Choose the condition and product scope

Pick the condition type.

Then use Applies to and the product or variant picker to define the eligible range.

4

Set the purchase type

Choose the correct Purchase Type.

Use this to limit the offer to One-time purchase, Subscription, or the supported purchase types in your store.

5

Set the discount value

Add the Discount Note if you want customer-facing cart messaging.

Choose the discount type, then enter the value.

6

Add tiers if needed

Use Add Discount Tier when the discount should increase with quantity.

If your store shows Tier application method, choose how the tiers should behave.

7

Set usage and display options

Use Max uses per order to cap how many items can receive the discount.

Then review the optional display settings such as stacking, product-page pricing, and cart upsell messaging.

8

Set eligibility, dates, and save

Choose the correct Customer Eligibility.

Set the Active Dates, save the discount, then test with a fresh cart.

Flat vs cumulative tiers

Use Flat when the highest qualifying tier should apply to all eligible items.

Use Cumulative when each tier should apply progressively.

Example:

  • Flat — buy 4, qualify for the 4+ tier, get that tier on all 4 items

  • Cumulative — buy 4, get the lower tier on the first band and the higher tier only on the next band

Use Flat for simple shopper-facing offers.

Use Cumulative when you want true stepped pricing.

Optional settings that matter most

Max uses per order

Use this when only part of the cart should receive the offer.

Leave it blank only if unlimited use is intentional.

Allow stacking with other Roadmap Product Discounts

Turn this on only when the overlap is deliberate.

If two product discounts can target the same item, test the combination before launch.

Show discounted prices on product detail pages

Use this when you want the product page to preview the offer.

This setting needs theme-level support.

Show upsell message in the cart

Use this when the discount should encourage shoppers to add more items.

This setting also needs theme-level support.

Use product discounts when

Choose a product discount when you want:

  • only selected items discounted

  • bundle or mix-and-match logic

  • product-specific tiers instead of a whole-cart discount

If the whole basket should be discounted instead, use an order discount.

Test before launch

Run these three tests:

  1. a cart that should not qualify

  2. a cart that should qualify once

  3. a larger cart that should test the tier or usage limit

If eligibility uses tags, membership, or login status, test with a real customer account.

Last updated