Add a Cart Discount

Managing discount that are applied to a customer's cart

A cart discount applies to a cart's products or other aspects of the cart like shipping fees.

Cart discounts are useful when for the following scenarios:

• "10% off everything" sales.
• Free shipping discounts, or free shipping over a certain cart amount.
• Seasonal sales for a group of products.
• Membership or customer group discounts.
• Free gift with purchase discounts.
• "Buy one get one" discounts.

You can create two types of cart discounts:

• Numeric: applies a relative or absolute value discount to a cart.
• Gift line item: adds a specific product to the cart.

Cart discounts apply after adding a product to the cart, and are applied in order of their Rank (sortOrder) value. Cart discounts can also set an Do not apply any further cart discounts after this one option, which stops the commercetools platform from applying any discounts that rank lower than the one with the option activated.

The number of active cart discounts for one discount code is currently limited to 10. The number of active cart discounts that do not require a discount code is limited to 100.

Creating a numeric Cart Discount

1. In the Merchant Center's main menu, navigate to Discounts > Add discount, and click Add cart discount.

2. Select Numeric in the Cart discount type field.

3. Provide values for the following fields:

   • Cart discount name (Required): the display name for the cart discount.
   • Cart discount description: a plain-text description of the discount.
   • Discount value (Required): the discount type (Relative or Absolute) and the amount.
   • Rank (sortOrder) (Required): the relative importance of the discount as a decimal value from 0 to 1. A larger value ranks higher.
   • Do not apply any further cart discounts after this one: Check if you do not want discounts ranked lower than this one to apply.
   • Valid from: the date from which the discount is valid to apply to a cart.
   • Valid until: the date from which the discount is invalid to apply to a cart.
   • Discount code: whether a discount code is required or not.

4. In the Cart Discount rules section, configure the conditional statements.

5. In the Cart discount target section, configure the conditional statements. 

6. Click Save.

Discounts are always created in the deactivated state. To apply a discount, you must activate it first.

Creating a gift Line Item Cart Discount

1. In the Merchant Center's main menu, navigate to Discounts > Add discount, and click Add cart discount.

2. Select Gift line item in the Cart discount type field.

3. Provide values for the following fields:

   • Cart discount name (Required): the display name for the cart discount.
   • Cart discount description: a plain-text description of the discount.
   • Under Choose gift line item, fill in the following fields:
     • Product id (Required): The Product ID of the gift line item. You can find this in the Product's Merchant Center URL.
     • Variant id (Required): The Product Variant ID of the gift line item. You can find this by navigating to a specific product and clicking the Variants tab.
     • Supply channel: The supply channel of the product.
     • Distribution channel: The distribution channel of the product.
   • Rank (sortOrder) (Required): the relative importance of the discount as a decimal value from 0 to 1. A larger value ranks higher.
   • Do not apply any further cart discounts after this one: Check if you do not want discounts ranked lower than this one to apply.
   • Valid from: the date from which the discount is valid to apply to a cart.
   • Valid until: the date from which the discount is invalid to apply to a cart.
   • Discount code: whether a discount code is required or not.

4. In the Cart Discount rules section, configure the conditional statements. See Configuring cart discount rules for more information.

5. Click Save.

Discounts are always created in the deactivated state. To apply a discount, you must activate it first.

Configuring Cart Discount rules and targets

To configure a cart discount rule:

1. Configure the Cart discount rule, which defines which carts to apply the discount to.
2. Configure the Cart discount target, which defines what kind of discount to apply.

Configuring a Cart Discount rule

If you select This discount only applies to carts... in the cart discount rule builder, you can create a rule which applies a cart discount to the cart or products in it.

Selecting a condition option

After selecting This discount only applies to carts..., select one of the following conditions:

• ... if all of the following conditions are met: All rules defined must be true in order for the discount to apply. Shows AND buttons when creating additional rules.
• ... if any of the following conditions are met: Any rule defined must be true in order for the discount to apply. Shows OR buttons when creating additional rules.
• ... if the following condition does NOT contain: The rule defined must be false in order for the discount to apply. You cannot define multiple rules with this operator type.

Defining a rule

Three aspects of a discount rule:

• A predicate, which identifies data in the commercetools platform associated with a cart.
• An operator, which checks the state of the data.
• Values, which you input to check the predicate data against.

To define a discount rule:

1. Select a predicate from the first drop-down menu.

   By default, the drop-down menu does not show all predicates. Select Show more... in the drop-down menu to see which predicates are available.

2. Select an operator from the next drop-down menu.

3. Provide or select a value to compare to in the next field.

   The value field's input type changes based on the predicate and operator, and in some cases is not present at all.

4. (Optionally) define subgroups for a rule or additional rules using the AND or OR buttons if available. a. Select Add subgroup for this rule and fill in the input fields as required to create a sub-group (nested) rule. Select Add new rule and fill in the input fields as required to create a non-nested additional rule.

Configuring a Cart Discount target

The cart discount target defines what aspects of the cart receive a discount. To configure a cart discount target:

1. Select one of the following discount targets:

• Line items: applies the discount to the price of line items in the cart.
• Custom line items: applies the discount to the price of custom line items in the cart.
• Multibuy line items: applies the discount when a customer purchases a certain quantity of line items. Used for "Buy one get one" discounts. For more information, see Configuring multibuy discounts.
• Multibuy custom line items: applies the discount when a customer purchases a certain quantity of custom line items. Used for "Buy one get one" discounts. For more information, see Configuring multibuy discounts.
• Shipping: applies the discount to the cart's shipping cost.

2. Configure the rule.

• To configure Line items, Custom line items, and Shipping
• To configure Multibuy line items and Multibuy custom line items, see Configuring multibuy discount targets.

Configuring multibuy Discount targets

Multibuy line items apply a discount when the customer purchases a certain quantity of line items. Multibuy line item discounts are useful for "Buy one get one" promotions.

To configure a Multibuy line item or custom line item discount:

1. Select a condition option. 
2. Configure the multibuy line item fields

• When a customer buys: the total line items (quantity) a customer must buy before the applying the discount.
• line items, he/she gets: the quantity of line items to which to apply the discount. The discount applies to the following, as selected from the drop-down:
  • The cheapest item
  • The most expensive item
• ... % off: automatically populated from on the discount value provided when creating a cart discount.
• Limit this discount to: limits how many times the discount can be applied. You can either provide a value in the Add quantity field, or check the Unlimited checkbox.

Activating a Cart Discount

1. Navigate to the discount you want to activate.
2. In the upper right hand corner, click the Status slider.
3. In the popup which appears, click Activate discount.

Duplicating a Cart Discount

You can duplicate an existing cart discount to save time when setting up a new cart discount.

1. Navigate to the discount you want to duplicate.
2. In the upper right hand corner, click the Duplicate button.
3. Click Save.