HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback


Components mentioned here are available in the EPiServer.Commerce.Marketing namespace.

A promotion is a marketing tool used to increase sales of certain products or product lines. There are three promotion types.

  • **EntryPromotion** – Applies reward to a specific entry.

  • **OrderPromotion** – Applies reward to entire order.

  • **ShippingPromotion** – Applies reward to order's shipping cost.

## Included promotion types

### Item promotions

  • **Cheapest items for free** – Buy at least X items, get the cheapest Y for free.

  • **Most expensive items for free** – Buy at least X items, get most expensive Y for free.

  • **Buy products for fixed price** – Buy X items from catalog entries for a fixed price.

  • **Buy products for discount from other selection** – Buy at least X items, get discount on selected items.

  • **Buy products for discount on all selections** – Buy at least X items, get discount on all.

  • **Buy products for discount in same category** – Get discount an all items in selected category.

  • **Spend for discounted selection** – Spend amount to receive a discount on selected items.

  • **Spend for free items** – Spend amount to receive gift items.

### Order promotions

  • **Spend for discount on order** – Spend amount to receive discount on total order value.

  • **Buy products and get discount on order** – Buy at least X items, get discount on total order value.

### Shipping promotions

  • **Spend for discount on shipping cost** – Spend amount to get discount on shipping cost.

  • **Buy products for discount on shipping cost** – Buy at least X items to get discount on shipping cost.

  • **Buy products for free shipping** – Buy at least X items and get free shipping.

  • **Spend for free shipping** – Spend amount to get free shipping.

If an order has several shipments, the shipping discount only applies to the shipment with the highest shipping cost.

For example: Shipment 1 has a shipping cost of $39.76. Shipment 2 in the same order form has a shipping cost of $28.00. If you apply a 10% discount, the discount amount is $3.98.

## Extend promotions example

Sometimes it is useful to add properties to promotions for marketing purposes but use the base processor for evaluation.



## Use render templates

Promotion content uses normal rendering templates as described here. By default, only partial views are available for promotion content.



**Example:** The corresponding rendering view for displaying the promotion partial view.



**Related blog post:** [Old promotion system is (already) dead, long live the new promotion system](🔗)