How to Use Buy X Get Y
Summarize this post with AI
On this page
Buy X Get Y lets you reward customers with a discounted or free product when they buy the items you choose. The offer appears as a widget on the product page, with a progress bar that shows how close the customer is to unlocking the reward. Use it to raise order value, move slow-selling stock, or introduce new products as gifts. The widget shows on product pages only.
1. Overview
What customers see. On the product page, the widget shows the products to buy and the reward. Customers can pick variants (color, size…) for each product, follow their progress, see the total and the amount they save, and add the whole offer to the cart with one button.
When the offer shows. The widget appears only when all of these are true:
- The customer is on a product page.
- The product being viewed is in the Customer buys list of the offer.
- The offer status is Active (not Inactive or Not published).
If several offers match the same product, the page shows only one: the offer with the smallest Priority number.
2. Key terms
- Offer – one complete "buy X, get Y" deal: purchase requirement, reward and discount.
- Customer buys (X) – the products customers must buy to qualify.
- Customer gets (Y) – the products customers receive at a discounted price once they qualify.
- Purchase requirement – how "bought enough" is measured: per product, by total quantity, or by amount spent.
- Unlock – when the customer has bought enough of X, the reward changes from Locked to available.
- Priority – when several offers match, the smaller number wins.
- Variant – one combination of options, for example "Blue / M", with its own price and stock.
3. Install Buy X Get Y extension
4. Create an offer
- In EComposer, go to Optimize → CRO Extensions → Buy X Get Y and click Open.
- Click Create offer.
- In Quick start, pick a starting point (Buy X, get Y free, Buy X, get Y at a discount, Spend & get a gift, or Custom offer) and click Continue through Offer type → Customer buys → Customer gets. Choose Custom offer to skip the quick start and set everything up in the builder.
- Set up the offer in the Offer tab (see below), then click Save.
The offer list lets you filter offers by All, Active, Expired and Inactive, edit an offer, or open its analytics. Use the Setup guide at the top to create your first offer and Enable analytics.
- Create offer starts a new offer.
- Performance overview shows Views, Revenue, Orders, Conv. rate and AOV uplift for the last 7 days.
- The offer list shows each offer's name, Status and Schedule.
The builder sidebar has three tabs: Offer, Content and Design. (Panel headers may read "Offer configuration", "Widget contents" and "Widget UI".)
- Priority for the offer.
- Customer buys section.
- Customer gets section.
- Choose the offer type, for example Buy X, get Y free.
- Click Continue.
4.1. Offer information
- Offer name – required, up to 255 characters. Customers see this name on your store.
- Offer description – optional, shown under the name.
- Active – turn on to run the offer. New offers are off by default.
- Priority – when several offers match, the lower number applies first.
4.2. Customer buys
- Choose a Purchase requirement:
- Specific products – customers must buy the set quantity of each selected product.
- Any mix of products – customers buy any products from the list until they reach the Required quantity.
- Spend a minimum amount – customers spend at least the Minimum amount on the selected products.
- Under Products and quantities, search in Select products or click Browse (1 to 15 products).
- Set a quantity for each product (1–30). For Specific products this is the required quantity; for the other two types it is the maximum counted for that product. The offer applies to all variants of a product; customers pick the variant in the widget.
- Offer name.
- Active toggle.
- Purchase requirement.
- Products and quantities.
4.3. Customer gets
- Choose a Reward:
- Specific products – the products under Products to add are added to the cart automatically when the offer unlocks.
- Customer chooses – customers pick their reward from your list. Set Items customer can choose (minimum 1).
- Add reward products (up to 10) and a quantity for each (1–30).
- Under Reward offer, set the Discount type and Value:
- Percentage (0–100). Enter 100 to make the reward free.
- Fixed amount – cannot exceed the total value of the reward.
- Reward.
- Products to add.
4.4. Advanced
- Schedule this offer – set a start and end time (in your local time) so the offer turns on and off automatically.
If a field is invalid when you save, it is highlighted with the message "Invalid field(s). Please check and try again." and the section with the error opens automatically.
4.5. Offer statuses
- Not saved – the offer is being created and has not been saved yet.
- Inactive – saved but turned off; customers don't see it.
- Not published – turned on but not ready to show yet. Save the offer again to retry.
- Active – running and visible to customers.
4.6. Delete an offer
Click the ⋮ menu on the offer row and choose delete, then confirm Are you sure?. This cannot be undone, and the offer stops showing on your store.
5. Example offers
- Buy a shirt and a hat, get a free sticker
- Purchase requirement: Specific products – Shirt × 1, Hat × 1.
- Reward: Specific products – Sticker × 1.
- Discount type: Percentage, Value: 100.
- Customers choose the shirt and hat variants; the sticker is added automatically and shows as Free.
- Buy any 3 items, choose 1 gift at 50% off
- Purchase requirement: Any mix of products – Required quantity: 3.
- Reward: Customer chooses – Items customer can choose: 1.
- Discount type: Percentage, Value: 50.
- The progress bar counts items added out of 3. At 3 items, the reward unlocks and the customer picks 1.
- Spend $100, get a free gift
- Purchase requirement: Spend a minimum amount – Minimum amount: 100.
- Reward: Specific products.
- Discount type: Percentage, Value: 100.
- The progress bar shows the amount spent, and the button reads "Spend … more to unlock" until the minimum is reached.
6. Customize the display
Unlike Fixed Bundle, display settings in Buy X Get Y are saved per offer, so each offer can have its own text, colors and style. Preview your changes on desktop or mobile in the builder.
6.1. Content tab
- Header – Title and Subtitle. Leave blank to hide.
- Progress Bar – show or hide the progress bar and line, the "Your progress" label, and progress text by quantity or amount. The progress bar shows only for Any mix of products and Spend a minimum amount.
- Product Card – show or hide price, selected variant and quantity label; button text for "Add items", "Add more", "Added", "Remove", and the "Sold out" label.
- Customer Gets Section – reward heading ("Your free reward preview"), "Gift" label, selected-gift counter, "Free" and "Locked" labels.
- Footer Summary – total items line and the "You save …" line (leave blank to hide).
- Add to Cart – button text and messages for: add more items, spend more, offer unavailable, and choose your gift.
All text can be entered per language, so customers see the text in the language they browse your store in. Many fields accept dynamic values such as {{remaining}}, {{amount}}, {{total}} and {{percent}}.
- Open the Content tab.
- Edit the Title and Subtitle of the header.
- Expand Product Card, Customer Gets Section, Footer Summary, Add to Cart and Cart Messages.
6.2. Design tab
- Color tokens – 9 colors (background, text, border, accent, text on accent, progress bar, savings text, gift label, text on gift label). Pick from Presets (Default, Shopify, Warm cream, Classic blue, Night outline, Pure black) or edit each color.
- Density – Default / Compact / Spacious.
- Corner style – Default / Square / Soft / Pill.
- Container border – Default / None / Thin / Thick.
- Card size and Button size – Default / Small / Large.
- Font – Default / System / Sans / Serif / Rounded.
- Open the Design tab.
- Color tokens and Presets.
- Density, Corner style and Container border.
7. Add the widget to your product page
Add the widget like any other block:
- In EComposer: in the page builder, find CRO Extension and drag the Buy X Get Y element into place.
- In the Shopify theme editor: add the CRO BXGY / Gift block where you want it.
The block works on product pages only. It shows automatically when the product on the page is in the Customer buys list of an Active offer; otherwise nothing shows. Content and design come from the offer, so there is nothing else to set up in the page builder.
8. Customer experience
- Variants and quantities – customers choose variants for each product; sold-out variants are dimmed and can't be selected. For Specific products, quantities are fixed. For Any mix of products and Spend a minimum amount, customers change quantities and click Add items to count them toward progress.
- Unlocking the reward – until the requirement is met, the reward is dimmed with a Locked label. Once it is met, the reward unlocks: with Customer chooses, customers pick up to the allowed number; with Specific products, the reward is already selected.
- Sold-out items – the offer shows "Currently unavailable" and the button is disabled.
- Add to cart button – the text changes with progress: "Add … more to unlock", "Spend … more to unlock", "Choose your gift to continue", or "Add offer to cart • total" when ready. One click adds the whole offer (products and reward) to the cart.
- Discount – the reward discount is applied automatically in the cart and at checkout. No discount code is needed.
9. Buy X Get Y Analytics
To open analytics, click View full analytics in Performance overview on the offer list. If analytics is not on yet, click Enable analytics in the Setup guide first. Use the campaign selector and date range at the top to filter the data, and Refresh to update it.
Overview
Revenue, Orders, Conversion rate and Average order value, each with a chart for the selected date range.
- Campaign selector and date range.
- Revenue, Orders, Conversion rate and Average order value charts.
- Funnel section.
Funnel and more
- Funnel – Views → Added to cart → Checkout started → Orders.
- Performance
- Top products sold in bundles
- Views by device type – Mobile, Tablet and Desktop.
The sections stay empty until your offers record activity in the selected date range.
- Funnel.
- Performance.
- Top products sold in bundles.
- Views by device type.
FAQ
Where does the offer show? Only on product pages, and only when the product is in the Customer buys list of an Active offer.
Two offers include the same product. Which one shows? The offer with the smallest Priority number.
My offer is turned on but says Not published. What should I do? The offer is not ready to show yet. Save it again to retry.
Can each offer look different? Yes. Content and Design settings are saved per offer.
Do customers need a discount code? No. The reward discount is applied automatically in the cart and at checkout.