Promotions
Features described on this page require the Xperience by Kentico Advanced license tier.
Promotions allow you to offer discounts and special offers to your customers. The system evaluates active promotions during checkout and automatically applies the best available discount.
To learn how to create and manage promotions in the administration, see Manage promotions.
Xperience by Kentico provides a promotion framework that allows developers to implement custom discount rules. The framework integrates with the price calculation API to automatically apply promotions during checkout.
Promotion types
The system supports different types of promotions based on when and how discounts are applied:
|
Promotion type |
Description |
Use cases |
|
Discounts applied to individual products during price calculation. The system evaluates all applicable promotions and automatically selects the best discount for each product. Only one promotion can apply per product. |
|
|
|
Discounts applied to the entire order total. Order discounts are evaluated after catalog discounts and can be combined with product-level promotions. Only one order discount can apply per order. |
Order total discounts based on shopping cart contents, total price, etc. |
Discount applicability and priority
Discounts in Xperience can be combined and stacked in various ways. Promotions are evaluated during the price calculation pipeline:
- Catalog discounts are evaluated first, applying product-level discounts based on configured promotion rules. The system evaluates all applicable promotions and automatically selects the best discount for each product.
- Order discounts are evaluated after product prices are calculated, applying order-level discounts to the total. The system evaluates all applicable order-level promotions and selects the highest eligible discount, applying it to the order total.
The selected price calculation mode also determines what types of promotion are evaluated. For example, catalog price calculation applies catalog discounts only. Additionally, the entire calculation pipeline can be customized to your preference.
The order creation service persists promotion data with orders for reporting and order history. Viewing order details in the Orders application provides a breakdown of each applied discount and its impact on the overall unit and order prices.
Redemption methods
Promotions support two redemption methods that control how customers receive discounts:
|
Redemption method |
Description |
|
Automatic |
The default behavior. Promotions are automatically evaluated and applied during price calculation when customers meet the configured conditions. |
|
Multi-use discount code |
Requires customers to enter a specific code (e.g., WINTER20) to receive the discount. The promotion is only applied if the customer provides the matching code. Codes are generic and can be used by any customer, any number of times during the promotion period. Single-use or customer-specific codes are not supported. |
Coupon codes can be configured for both catalog discounts and order discounts. For implementation details, see Coupon codes.
Use coupon codes for targeted marketing campaigns, newsletter subscriber discounts, influencer partnerships, or limited-time promotional offers.
Implement promotions
- Catalog discounts – See Implement catalog discounts for creating product-level promotion rules.
- Order discounts – See Implement order discounts for creating order-level promotion rules.
- Coupon codes – See Coupon codes for requiring discount codes for redemption.
Manage promotions
Marketers create and manage promotions in the administration interface. After you register a promotion rule in code, it becomes available for selection when creating new promotions.
Promotions support:
- Activation scheduling – Set start and end dates for time-limited offers.
- Configurable properties – Define promotion parameters (discount percentage, target categories, eligibility rules) through the admin UI.
- Redemption methods – Choose between automatic application or require customers to enter a discount code.
- Multiple active promotions – Run several promotions simultaneously with automatic best-discount selection.