FAQ

Edit promotions

How can I modify a promotion? Are there any limitations on the details I can change?

You can edit promotions by accessing the promotion management interface. You have the flexibility to update all aspects of the promotion except for the promotion type, which remains fixed. Feel free to adjust details such as the promotion's name, description, duration, and eligibility criteria.

Any changes made to a promotion are applied immediately. However, it may take a few minutes for all caches to be updated with the modified information.

Check Edit a promotion.

Are there any requirements I need to consider before deleting a promotion? For instance, should the promotion be inactive, or if it's active, should it not be within the current timeframe?

There are no specific rules for deleting promotions. Once deleted, a promotion is immediately removed from the system. However, it might take a few minutes for all caches to be invalidated, ensuring the removal is reflected throughout the system. If a user has the promotion active in their basket at the time of deletion, the promotion will be removed from their basket as well.

For more details, check Delete promotion and deactivate promotion.

Multiple promotions

What happens if a user combines a promotion with a voucher? Is there a way to prevent this?

We support this feature by allowing you to configure it on the voucher itself.

What happens if the user has promotion applied but the promotion or the condition changed?

Sometimes, promotions might change or become inactive. If this happens, the basket will remove the promotions that are no longer available. This ensures that the customer always get accurate discounts or benefits.

For more details, check Multiple promotions order and Understanding promotions.

How does the system apply multiple promotions when a product is eligible for more than one?

When a product or basket is eligible for multiple promotions, SCAYLE applies them based on predefined stacking rules. The system automatically calculates the best combination of discounts, such as product-specific promotions, basket-wide offers, and promo codes. This ensures customers receive the maximum applicable savings while avoiding conflicts. Merchants can maintain control over discount interactions, delivering the best value to customers according to their business rules.

Examples: Item level

Scenario	Reduction	Expected Result
A customer adds one eligible item (Men's Jeans) to the cart.	Promotion 1: 20% discount on Product A. Promotion 2: 10% on all men's collection	Both promotions are applied correctly to the item.
A customer adds one eligible item Product A (Men's Jeans) to the cart.	Promotion 1: Buy one get one free (BXGY) on Product B. (BXGY always applied on free product) Promotion 2: 20% discount on Product A	Both promotions are applied correctly to the items. 20% on Jeans.
A customer adds one eligible item Product A (Men's Jeans) to the cart.	Promotion 1: 20% discount on Product A Promotion 2: 20% discount with code FLAT20	Both promotions are applied correctly to the items.
A customer adds two eligible items (Product A and Product B) to the cart.	Promotion 1: Buy one get one free (BXGY) on Product A Promotion 2: 20% discount on Product B	Both promotions are applied correctly to their respective items, reflecting the BXGY offer on Product A and the 20% discount on Product B.
A customer adds two eligible items (Product A and Product B) to the cart.	Promotion 1: 10% discount on Product A Promotion 2: 20% discount on Product B	Both promotions are applied correctly to their respective items, reflecting the 10% discount on Product A and the 20% discount on Product B.

Examples: Basket-level

Scenario	Reduction	Expected result
Customer adds three eligible items to the cart (Product D, Product E, and Product F).	Promotion 1: 10% discount on the total order value above 50. Promotion 2: 10% discount on orders containing Product E.	Both promotions are applied correctly. Since the total order value exceeds 50, the 10% discount is applied. Additionally, since Product E is in the cart, 10% additional discount is also applied to the order. Order of application matters - check with BSKT
Customer adds three eligible items to the cart (Product D, Product E, and Product F).	Promotion 1: 10% discount on the total order value above 50. Promotion 2: 20% discount with promo code FLAT20.	Both promotions are applied correctly. Since the total order value exceeds 50, the 10% discount is applied. Additionally, 20% additional discount is also applied to the order.
Customer adds a mix of items to the cart (Product O, Product P, Product Q, and Product R).	Promotion 1: Buy Product O and Product P together and get 30% off on Product Q. Promotion 2: Buy any 2 items from a specific category and get 20% off on the cheapest item. Promotion 3: Free gift (Product S) on orders above 100.	The system applies the discount on Product Q when Product O and Product P are both in the cart. Then, it identifies two items from the specified category (if applicable) and applies the 20% discount to the cheapest one. Finally, if the total order value exceeds 100, the free gift is added to the cart.

Scenario

Reduction

Expected result

Customer adds three eligible items to the cart (Product D, Product E, and Product F).

Promotion 1: 10% discount on the total order value above 50.
Promotion 2: 10% discount on orders containing Product E.

Both promotions are applied correctly. Since the total order value exceeds 50, the 10% discount is applied. Additionally, since Product E is in the cart, 10% additional discount is also applied to the order.

Order of application matters - check with BSKT

Customer adds three eligible items to the cart (Product D, Product E, and Product F).

Promotion 1: 10% discount on the total order value above 50.
Promotion 2: 20% discount with promo code FLAT20.

Both promotions are applied correctly. Since the total order value exceeds 50, the 10% discount is applied. Additionally, 20% additional discount is also applied to the order.

Customer adds a mix of items to the cart (Product O, Product P, Product Q, and Product R).

Promotion 1: Buy Product O and Product P together and get 30% off on Product Q.
Promotion 2: Buy any 2 items from a specific category and get 20% off on the cheapest item.
Promotion 3: Free gift (Product S) on orders above 100.

The system applies the discount on Product Q when Product O and Product P are both in the cart. Then, it identifies two items from the specified category (if applicable) and applies the 20% discount to the cheapest one. Finally, if the total order value exceeds 100, the free gift is added to the cart.

Examples: Mixed-level

Scenario	Reduction	Expected result
Customer adds a mix of items to the cart (Product K, Product L, Product M, and Product N).	Promotion 1: 20% discount on Product K. Promotion 2: Buy two eligible items and get 50% off on the third one. Promotion 3: 10% EXTRA discount on orders above 75.	The system applies the 20% discount to Product K. Then, it identifies two items eligible for the buy-two-get-one-50%-off promotion and applies it to the cheapest one. Finally, if the total order value exceeds 75, 10% is applied
Customer adds a mix of items to the cart (Product T, Product U, Product V, and Product W).	Promotion 1: Buy any 3 items from a specific brand and get 25% off on the third one. Promotion 2: Buy Product T and Product U together and get a fixed discount of 10. Promotion 3: 20% discount with promo code FLAT20.	The system applies the 25% discount on the third item from the specified brand if three items from that brand are present in the cart. Then, it applies the 10 fixed discount when both Product T and Product U are in the cart. Finally, when FLAT20 code is applied 20% discount is applied to the whole order.
Customer adds a mix of items to the cart (Product X, Product Y, Product Z).	Promotion 1: Buy any 2 items and get 50% off on the cheapest one. Promotion 2: Buy Product X and Product Y together and get a free accessory (Product AA). Promotion 3: 15% discount on orders containing at least one item from a specific collection.	The system applies the buy-two-get-50%-off promotion to the cheapest item when two items are in the cart. Then, it adds the free accessory (Product AA) when both Product X and Product Y are present. Finally, if at least one item from the specified collection is included, a 15% discount is applied to the entire order.
Customer adds four eligible items to the cart (Product G, Product H, Product I, and Product J).	Promotion 1: Buy 3 items(Product G, Product H, Product I) and get the one(Product J) for free. (BXGY) Promotion 2: 25% discount on orders containing at least one Product G.	The promotion engine identifies the three cheapest items (excluding Product G) and applies the "buy 3 get cheapest free" promotion. Additionally, if Product G is included, the 25% discount is applied to the entire order.

Audiences

What is the an audience and what is the difference to a customer group?

Audiences within our promotion engine are finely tuned segments that enable precise customer outreach. These subsets let you craft tailored messages and promotions, ensuring resonance with specific customer characteristics, behaviors, or preferences. Customer groups serve as broader categories for organizing clientele based on shared Attribute Groups. While useful for general organization, they lack the targeted precision of audiences.

For more details, check Audiences.

API

Can I use an API to manage promotion settings, including creating, updating, and deleting promotions?

For details how to manage Promotion via API, check our Developer Guide.

Advanced template

Which prices count towards a minimum basket total condition, that can also be configured using the expression payload.totals.withTax via the advanced template ?

The prices of items not assigned to a buy x get y promotion after discounts of sales and price campaign, but before discounts of vouchers and automatic_discount promotions are counted towards the minimum basket total condition. Fees also do not count towards the minimum basket value.