Creating Buy X get Y discounts

Use Buy X get Y when a qualifying purchase should unlock discounted reward items. Open Discounts > Create discount > Buy X get Y > Continue. The Help banner on the creation page opens this guide.

Choose the method

Select Discount code or Automatic discount, then enter the code or customer-facing title. Use at least three characters. Set Draft while preparing the offer; new forms start Active.

Prepared example only. No promotion was created or redeemed. Select an image to enlarge it.

Define what the customer buys

1. In Customer buys, set Minimum quantity of items, such as 2.
2. Click Add condition to choose qualifying products, variants, collections, product types, tags, or vendors.
3. Complete each attribute, operator, and value. Multiple rows restrict the same eligible item set with AND.

Leaving the buy-side item conditions empty means no product restriction on that side. Add conditions when only a particular group should qualify. This type uses its buy quantity rather than the separate Minimum requirements block shown for other discount types.

Define what the customer gets

1. In Customer gets, set Quantity of items the discount applies to, such as 1.
2. Add the reward-side conditions identifying the eligible reward products or variants.
3. In At a discounted value, choose Free, Percentage off, or Amount off each.
4. Enter the value for percentage or fixed rewards. Free does not require an amount.
5. Optionally set Maximum number of uses per order to limit how many times the offer repeats.

The real reward editor. The offer remains unsaved. Customer buys and Customer gets are separate item-condition blocks.

For Amount off each, the fixed reward value applies per rewarded unit, capped by that unit's price. This differs from a fixed Amount off products discount distributed across eligible lines.

If the buy and reward sets overlap, the calculation reserves higher-priced qualifying units for the buy side and discounts the cheapest eligible remaining reward units. For a “buy 2, get 1 free” offer on the same product set, the cart needs at least three qualifying units for one reward. If it contains only two, there is no separate reward unit to discount.

Leaving Maximum number of uses per order empty lets the offer repeat as far as the cart's available qualifying and reward quantities allow. It does not remove the buy requirement for each repetition.

Review eligibility, combinations, and scheduling

Set Customer eligibility conditions if the promotion is restricted to certain customers, segments, countries, sales channels, or markets. Empty eligibility allows all customers; signed-in customer/segment and shipping-address requirements still apply to their respective conditions.

For a code, optionally configure total-use and one-use-per-customer limits. These differ from the per-order repetition limit above. Review Combinations and Active dates, then confirm Draft or Active status.

Both discounts must permit a combination. Competing product promotions can affect which reward reduction is selected, so check the actual checkout result.

Create and test the offer

1. Review both sides' quantities and conditions, reward value, repetition limit, method, eligibility, dates, and status.
2. Click Add, resolve any errors, and reopen the created discount. Existing edits use Save.
3. Test a cart with qualifying purchases and reward items, one with no reward item, and one below the buy quantity.
4. Check repetition limits and the specific units discounted, especially when the two sets overlap.

No real checkout or customer redemption was performed for the guide. Its allocation behavior was reviewed in the current calculation code.

Troubleshooting