Buy X get Y, free gifts, bundles and tiers
How Playwright Checkout Rules counts the items in multi-item offers, so you can set them up to give exactly what you mean.
How Buy One Get One counts
The Buy One Get One template has a “buy” selection, a “get” selection, and three numbers: Buy number, Get number and Maximum sets.
- Playwright counts the units in the cart that match the “buy” selection.
- Sets = that count ÷ Buy number, rounded down, and no more than Maximum sets (0 means no limit).
- It discounts sets × Get number units that match the “get” selection, cheapest first.
- The cart also needs at least Buy number units in total.
| Buy 2 shirts, get 1 hat | Shirts in cart | Hats in cart | Hats discounted |
|---|---|---|---|
| Buy number 2, Get number 1 | 1 | 1 | 0 |
| 2 | 1 | 1 | |
| 4 | 1 | 1 (only one hat) | |
| 4 | 2 | 2 | |
| Maximum sets 1 | 4 | 2 | 1 |
Buy one, get one on the same product
When “buy” and “get” select the same items, a unit can count as bought and as discounted. For “buy one, get one free” on the same product, use Buy number 2 and Get number 1: the customer adds 2 and one of them is free.
| Same product in cart | Buy 2 Get 1 at 100% | Buy 1 Get 1 at 100% |
|---|---|---|
| 1 | None free | 1 free (all of them) |
| 2 | 1 free | 2 free (all of them) |
| 3 | 1 free | 3 free (all of them) |
| 4 | 2 free | 4 free (all of them) |
The rule in general: to give “buy N, get M” on the same items, set Buy number to N + M and Get number to M. “Buy 2, get 1 free” is Buy 3 Get 1. The customer needs all N + M units in the cart, because Shopify Functions can’t add items for them.
Free gifts
Free Gift with Purchase (based on cart subtotal) and Free Gift with Purchase (based on shipping address) make one unit of a gift item free once it’s in the cart.
- Shopify Functions can’t add items to a cart. The customer adds the gift; Playwright makes it free. Say so on the product page, in the cart or in your promotion.
- The gift’s own price counts toward the subtotal. For “spend $50, get a $10 scarf free”, set the amount to $60.
- One gift per order, at 100% off unless you change the discount.
Bundles
Bundles and Bundles with conditions discount items bought together. Each bundle item is a product ID, variant ID, SKU, product type or product tag with a required quantity.
- Every bundle item must be in the cart in at least its quantity.
- Apply discount to full bundles only checked: only the units that make complete bundles are discounted. With a bundle of 1 shirt and 1 hat, a cart of 3 shirts and 1 hat gets 1 shirt and the hat discounted.
- Unchecked: once there’s one full bundle, every matching unit is discounted. The same cart gets all 3 shirts and the hat discounted.
- Items an earlier rule discounted don’t count toward a bundle. Product tags match whole tags.
Tiered discounts
Tiered Discount gives the biggest discount among the tiers the cart reaches. Tiers can measure a customer tag, the cart subtotal, the cart’s quantity, the subtotal or quantity of the selected items, or each line’s own quantity.
- Subtotal tiers are whole dollars:
100means $100. - Customer tag tiers match whole tags.
- Each tier has its own message, shown with the discount.
Using several offers together
Rules run in order, and each sees the cart as earlier rules left it. All of Playwright’s line item discounts reach Shopify as one product discount, and they don’t combine with other product discounts. See Rule order and How codes combine.