Buy X Get Y

Buy X Get Y promotions automatically add pre-defined discounts to one or more items to a customer’s basket when specific conditions are met. You can define the rules - such as requiring the purchase of certain products or reaching a minimum order value - to trigger the promotion.

Setting up Buy X Get Y via SCAYLE Panel

Select the Shop where you want to create your promotion and go to Promotions ➜ Buy X get Y.
Click the + NEW BUY X GET Y button.
In the Name field, type a name for the promotion.
In the Display Name field, type the name of the promotion that will be shown to the customer during the Checkout Process as this information can also be used on E-mail templates and Invoices.
Usage limit of a promotion. A global switch that lets you cap how many times the promotion can be applied across all customers and baskets combined. When disabled, the promotion runs indefinitely until its validity period ends. When enabled, you choose the scope of the cap:
a. Total — limits the promotion across all customers globally. Once the counter is hit, no one can benefit from the promotion anymore, regardless of eligibility. Useful for "first 500 customers only" mechanics.
b. Customer — limits how many times a single customer ID can use the promotion across their order history. Useful for "one-time-per-account" mechanics.
Priority: enter the priority of the promotion compared to other (1 is the highest)s.
Start date: enter the date and time when the promotion starts running.
End date: enter the date and time when the promotion becomes inactive.
Countries: Select which shop countries that will be eligible for a promotion
Audiences: select audience(s) that will participate on the promotion
Allow promotions to be combined with other promotions on the basket or basket items. For details see Multiple Promotions on Item Level
Select the Customer Buy condition.
1. Define from which group the customer should Select Items From:
  1. Item Sets: The promotion will be applied in case items from Item Sets are bought
  2. Specific Product: The promotion will be applied in case specific Product IDs or Product Variants are bought
  3. Specific Categories: The promotion will be applied in case items from a specific category are bought
  4. Specific Attributes: The promotion will be applied in case items from a specific attribute are bought
  5. Any product: The promotion will be applied in case any item is bought (an MOV must be set)
2. Define what is the Minimum Unique Items of a Basket which needs to be bought by the customer (if customer buys is not set to item set) Hint: This option is hidden in case the user selected Items from Item Sets
3. Define what is the quantity logic that will define how many items the customer needs to buy (This option is hidden in case the user selected Items from Item Sets):
  1. Total amount of eligible items: Count of all variants within the basket (The sum of the qty of all items)
  2. Total amount of unique items: Count of all basket items (quantity for each is ignored)
  3. Total amount of unique items with the same variant ID: Count of quantity for a specific basket item (at least one variant should have the configured quantity)
4. Quantity: how many items the customer needs to buy for the condition to be applied
5. Set minimum order amount
Set where the Customer Gets the promotion::
1. Specific Products: promotion will be applied to specific Product IDs in case the conditions defined on the Customer Buys section are met
2. Same set of Customer Buys: the promotion will be applied to the cheapest item from the set the customer is buying (e.g. buy 2 T-shirts of a specific brand and get 10% of discount on the 3rd one)
3. Select the type of discount that will be applied: free, percentage and amount
4. Select the possibility to apply the discount proportionally to all items that are involved in the promotion. Example: in case there is a promotion of buy 2 T-shirts and get the 3rd one for free, the discount amount can be distributed proportionally amongst the 3 items
5. Select the maximum number of items the customer can redeem.
  This controls how many "Y" items are discounted per single promotion application — i.e., each time the Buy X trigger is satisfied once.
  Example: "Buy 2, get 1 free" → set this to 1. Each time the customer satisfies the "buy 2" condition once, they get 1 item free.
6. Select the maximum number of recurring redemptions in basket.
  This Controls how many times the promotion can be triggered in total during a checkout session. If left empty, it defaults to triggering once regardless of how many qualifying items are in the basket.
  Example: Set to 3 on a "Buy 2, get 1 free" promotion. A customer with 6 qualifying items triggers the promotion 3 times → 3 items free.
Click Create Promotion.

Examples

Here are some examples of how you might create some Buy X Get Y promotions:

Scenario 1: Buy two exact same items from a selected category and get 10% discount on one item.

On the Customer Buys Section, select:

The specific category that will enable the promotion
The amount of items which needs to be bought on the Basket so that the promotion can be valid
As the promotion will only be enabled in case 2 items from the same variant ID will be bought, select the "Total amount of Unique items with the same variant ID" as Quantity Logic
Include the amount of unique items which needs to be bought

On the Customer Buys, select the Discount Type amount and also the possibility of distributing it proportionally between the items that participate in the promotion.

Editing a Buy X Get Y promotion

Select the Shop where you want to edit your promotion and go to Promotions ➜ Buy X get Y.
Select the promotion.
Click the Edit button.
Note from here you can update your rules on the same template you used to create it OR
Deactivate the discount, for this click on the 3 vertical dots besides Edit and select Deactivate

Hint: On the right side you can see a nifty summary of all your promotion is doing!

Hit save

Deleting a Buy X Get Y promotion

Select the Shop where you want to edit your promotion and go to Promotions ➜ Buy X get Y.
Select the promotion.
Click on the 3 vertical dots besides “Edit” > Delete
Confirm on pop up

Setting Buy X Get Y up via Admin API

To create an Buy X Get Y discount using Admin API, see here.

Configure Advanced Buy X Get Y via SCAYLE Panel

To configure an advanced version of a Buy X Get Y promotion with conditions defined in CEL, see Advanced Buy X Get Y.