Promotions
With promotions, you can provide discounts to your customers. You can apply promotions automatically to all carts or you can create promotion codes that customers must enter to receive the discount. You can have multiple promotions active at the same time. Promotions have a fixed duration, with defined start and end dates, but you can also manually stop a promotion at any time.
Promotions can be applied to the entire cart or to individual items in the cart.
Cart-level promotions
Cart-level promotions are applied to all items in the cart. In the shopping cart, the discount amount is subtracted from each item in the cart.
Cart-level promotions include:
- Fixed discount: Reduce the product price by a fixed amount, such as $5.00 off.
- Percentage discount: Reduce the product price by the percentage specified, such as 10% off.
The following image shows a cart before and after a 10% Off promotion is applied. With the discount applied, the price for each item is reduced by 10% and the cart total reflects the reduction.
All items in the cart are eligible for cart-level promotions, even if they already have item-level promotions applied.
Item-level promotions
Item-level promotions are applied to each item that qualifies for the promotion. In the shopping cart, the item price reflects the applied discount.
Item-level promotions include:
- X for Y: Offer a bulk discount based on unit price, such as 2-for-1 sales.
- X for amount: Offer a bulk discount based on a fixed price, such as 3-for-$20 sales.
- Bundle: Offer a bulk discount when selected products are purchased together, such as buy any two items from a list for $100.
- Item fixed discount: Reduce the product price for multiple items by a fixed amount, such as $5.00 off. (API Only)
- Percentage item discount: Reduce the product price for multiple items by the percentage specified, such as 10% off. (API Only)
Multiple promotions for the same SKU
You can have multiple promotions that target the same SKU, however each instance of the SKU in the cart is eligible for only one item-level promotion. The promotions are applied in order of when the promotions are created, with the oldest promotion applied first. For each instance of the SKU that matches the criteria in the oldest promotion, the promotion is applied. If there are any remaining instances of the SKU, they are compared to the criteria for the next oldest promotion.
For example, letʼs say we have a cart with 1 BestEver Coffee Maker and 2 BestEver Coffee Grinders. We have an existing BestEver Coffee Maker + Grinder bundle promotion for $200.00, and we add a BestEver Coffee Grinders 10% Off percentage item discount promotion. The promotions are applied automatically, with no promotion code required. The items in the bundle are discounted to meet the bundle offer, then the remaining coffee grinder is discounted by 10%. The following table shows how the promotions are applied.
| Items | Promotion applied | Original price | Discounted price |
|---|---|---|---|
| 1 Coffee Maker | BestEver Coffee Maker + Grinder | $159.95 | $123.07 |
| 1 Coffee Grinder | BestEver Coffee Maker + Grinder | $99.99 | $76.93 |
| 1 Coffee Grinder | BestEver Coffee Grinders 10% Off | $99.99 | $89.99 |
Each coffee grinder receives the benefit of one promotion and the total is 289.99. The following image shows the cart total before and after the applied discounts.
If the promotions were reversed, with the BestEver Coffee Grinders 10% Off promotion being the older promotion, both coffee grinders receive 10% off and the BestEver Coffee Maker + Grinder promotion is never applied. The total is $339.93. If this is not the desired behavior, you can end the BestEver Coffee Grinders 10% Off promotion, create the BestEver Coffee Maker + Grinder promotion, and then create a new BestEver Coffee Grinders 10% Off promotion.
Promotion codes
You can apply promotions automatically to all customer carts or you can create promotion codes that customers must enter to receive the discount. Promotion codes can be group codes or individual codes. For example, you can offer a seasonal discount to all customers, such as SUMMER-SALE, or you can offer preferred customers unique discount codes. Promotion codes expire automatically at the end of the promotion period and are removed from the promotion.