How to Create a Buy X, Get Y free discount?

The Buy X, Get Y Free feature lets you run popular "Buy X, Get Y Free" promotions—like Buy 2 Get 1 Free or Buy 3 Get 2 Free.

The discount applies automatically to the lowest-priced eligible items in the cart, so customers always get the best value, and you maintain pricing predictability.

Perfect for:

To get started, navigate to Quantity X → Create Offer and choose Buy One Get One.

For Buy X, Get Y Free offers, you can choose between two layout options:

Show Image

👉 Note: Choice List layout is not available for Buy X, Get Y Free offers. These two layouts provide the clearest way to display free product offers.

By default, the widget appears on product pages. If you prefer, you can hide it from the product page and show it only in the cart and checkout pages.

If you want the discount to apply across your catalog, choose Whole store. For targeted promos, choose specific products or collections.

If you have selected Specific products/variants or Specific collections, click Browse to select the products and collections you want to include.

You can exclude products by specific collections or tags. For example, if you have products tagged as "clearance," you can exclude them from this offer if desired.

Here you define the requirements for the free product offer:

Here is how Buy X, Get Y Free works: When a customer buys the required quantity, the lowest-priced eligible items are automatically discounted to free. This ensures:

Example:

Create multiple discount levels to encourage larger purchases.

Example:

👉 This helps motivate customers to buy more by showing increasing rewards. You can add more tiers by clicking Add a tier.

For each tier, fill in:

Here, you can control the text customers see in your discount widget and cart.

Offer header – The main heading above your offer (e.g., "Buy more and get free products!")

Offer header tooltip – A question mark icon that reveals additional details when hovered (e.g., "The special offer applies only to the products listed in the promotion. When all the offer conditions are met you get free products.")

Discount tag – A short label that appears in the cart and checkout (e.g., "Quantity discount"). Use this to help customers understand the discount type.

👉 If the offer header and upsell message are switched off, the discount tag will still show in the cart/checkout.

Best practices:

Upsell messages help you encourage customers to add more items to their cart by showing progress and rewards. This increases average order value.

The progress bar visually shows customers how close they are to unlocking the next free product tier.

This message tells customers how many more items they need to get free products.

Example:
​"Add 1 more item(s) to your cart to get 2 free"

Variables you can use here:

This appears when customers have unlocked the free product offer, for exmaple, "Congrats! You've got 1 free product(s)"

You can use this variable: {free_product_number} → the number of free items unlocked

Best Practices:

The Advanced Settings section lets you control how your discount applies, choose price display options, and exclude certain customer groups.

You can choose how the discount should work based on product type:

👉 Choosing the right option depends on whether you want to promote variety (Any product) or volume of the same product/variant.

Here, you can choose who is not eligible for this discount:

On the right side of the screen, you'll see a Widget Preview showing exactly how your offer will look to customers:

This preview updates in real-time as you configure your settings, so you can see:

👉 Use this to verify your offer looks good before publishing!