# Cart Discounts and Discount Groups

Managing Discounts applied to a Customer's Cart

A Cart Discount applies to a Cart's Products or other aspects of the Cart, like shipping fees. They are applied after adding a Product to the Cart in the order of their **Rank (sortOrder)** value. The **Do not apply any further cart discounts after this one** option stops Cart Discounts (ranked lower than **Rank (sortOrder)** value) from applying.

They are useful when creating Discounts for the following scenarios:

- Free shipping discounts or free shipping over a certain cart amount
- Seasonal sales for a group of products
- Membership or customer group discounts

Cart Discounts are subject to a [limit](/api/limits.md#cart-discounts) in a Project.

Learn more about Cart Discounts in our self-paced [Cart Discounts](/learning-price-and-discount-your-products/cart-discounts/overview.md) module.

## Cart Discounts

### Create a Cart Discount

1. Go to **Discounts > Cart discount list**.

2. Click **Add cart discount**.

3. For **Cart discount type**, select **Numeric** for item or price discounts, or **Gift line item** to offer a free gift item with a cart purchase.

4. In the **General information** section, do the following:

   1. For **Cart discount name**, enter localized names for the Cart Discount.

   2. Optional: For **Cart discount description**, enter localized descriptions for the Cart Discount.

   3. Optional: For **Cart discount key**, enter a unique identifier value for the Cart Discount.

   4. Optional: For **Store**, select the Stores for which the Cart Discount should apply.

   5. Optional: For **Discount group**, select the Discount Group to assign the Cart Discount to.

      The Cart Discount is prioritized based on the Discount Group's ranking.

      This field is useful only for discounts with the following targets: [Item](/merchant-center/cart-discounts.md#item), [Buy and Get](/merchant-center/cart-discounts.md#buy-and-get), [Discount bundles](/merchant-center/cart-discounts.md#discount-bundles), and [Multibuy](/merchant-center/cart-discounts.md#multibuy).

   6. For **Recurring intervals**, select if the Cart Discount should apply to non-recurring and/or recurring Orders.
      - If you selected **Apply only to specific recurring intervals**, select the intervals for which the Cart Discount should apply.

   7. For **Rank (sortOrder)**, enter the rank for the Cart Discount.
      It determines the priority of the Cart Discount amongst others; a larger value is ranked higher.

   8. Optional: For **Stacking options**, select the **Do not apply any further cart discounts after this one** checkbox to prevent other lower-ranked Cart Discounts from applying.

      If the Cart Discount targets the total price of a Cart, then:

      - it applies after all other (active and valid) Cart Discounts, regardless of the sort order and stacking effect of the other Cart Discounts.
      - its sort order only determines the priority amongst other similar Cart Discounts (targeting the total price of a Cart). If the **Do not apply any further cart discounts after this one** checkbox is selected, lower-ranked Cart Discounts (targeting the total price of a Cart) are not applied.

   9. Optional: For **Discount code**, select **Required** if the Cart Discount should apply only when a Discount Code is applied to a Cart.

   10. Optional: For **Valid from**, select the date and time from when the Cart Discount is valid.

   11. Optional: For **Valid until**, select the date and time until when the Cart Discount is valid.

5. In the **Discount configurations** section, define the discount effect and the conditions under which the discount applies.

   - To discount the total price on a cart, see [Total price](/merchant-center/cart-discounts.md#total-price) for further instructions.
   - To discount items in a cart, see [Item](/merchant-center/cart-discounts.md#item) for further instructions.
   - To offer discounts such as "Buy one, Get one (BOGO)", see [Buy and Get](/merchant-center/cart-discounts.md#buy-and-get) for further instructions.
   - To group related products together and sell them at a combined (often discounted) price, see [Discount bundles](/merchant-center/cart-discounts.md#discount-bundles) for further instructions.
   - To offer free or discounted shipping cost for a cart, see [Shipping](/merchant-center/cart-discounts.md#shipping) for further instructions.
   - To add a gift item to a cart with a purchase, see [Gift item](/merchant-center/cart-discounts.md#gift-item) for further instructions.

6. After configuring the discount effects and conditions, click **Save**.

By default, new discounts are inactive and must be [activated](/merchant-center/cart-discounts.md#activate-a-cart-discount) to take effect.

#### Total price

- In the **Apply these discount effects** section, choose the target of the discount and define the effects for it.

  1. For **Apply this effect to**, select **Total Price**.
  2. For **Discount type**, select how the discount applies.
  3. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Item

- In the **Apply these discount effects** section, choose the target of the discount, items eligible for the discount, and define the effects for it.

  1. For **Apply this effect to**, select **Item**.

  2. For **Eligibility criteria**, select if the items of specific or all carts should be targeted.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators.md#predicate-syntax).

  3. For **Discount type**, select how the discount applies.

  4. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Buy and Get

- In the **Apply these discount effects** section, choose the target of the discount, the trigger conditions, items eligible for the discount, and define the effects for it.

  1. For **Apply this effect to**, select **Buy and Get**.

  2. For **Each time the cart contain(s)**, select if specific or all items in a Cart should trigger the discount.
     1. For **Count**, select the condition from the drop-down and enter the count.

        If you selected, **Specific items** earlier, define a condition or nested conditions that trigger the discount.

  3. For **Apply Discount on**, select if specific or all items in a Cart must be discounted.
     1. For **Count**, select the condition from the drop-down and enter the count.

        If you selected, **Specific items** earlier, define a condition or nested conditions for the items to be considered for the discount.

  4. For **Apply On**, choose if the cheapest or most expensive items in a Cart should be discounted.

  5. For **Allow multiple application within an order**, define how many times the discount can apply in an Order.

  6. For **With the following discount**, select how the discount applies and how it is distributed among eligible items in a Cart.

     For the **Percentage off** discount type:

     - If you selected **distributed evenly across all involved items**, then the discounted percentage is applied to the price of each targeted unit.
     - If you selected either of the other two modes, then the discount is calculated from the total value of the targeted units' eligible items. This discount is distributed among the targeted units and the units that triggered the discount.

  7. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Discount bundles

- In the **Apply these discount effects** section, choose the target of the discount, the trigger conditions, items eligible for the discount, and define the effects for it.

  1. For **Apply this effect to**, select **Discount bundles**.
  2. For **Apply Discount on**, select if specific or all items in a Cart must be discounted.
     1. For **Count**, select the condition from the drop-down and enter the count.

        If you selected, **Specific items** earlier, define a condition or nested conditions for the items to be considered for the discount.
  3. For **Apply On**, choose if the cheapest or most expensive items in a Cart should be discounted.
  4. For **Allow multiple application within an order**, define how many times the discount can apply in an Order.
  5. For **With the following discount**, select how the discount applies and how it is distributed among eligible items in a Cart.
  6. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Multibuy

For a more powerful and flexible solution, use the [Buy and Get](/merchant-center/cart-discounts.md#buy-and-get) or [Discount bundles](/merchant-center/cart-discounts.md#discount-bundles).

Multibuy discount target is available in [public beta](/offering/compatibility.md#public-beta) on the [Cart Discounts API](/api/projects/cartDiscounts.md).

- In the **Apply these discount effects** section, choose the target of the discount, items eligible for the discount, and define the effects for it.

  1. For **Apply this effect to**, select **Buy and Get** and click **old multibuy** in the notification.
  2. For **Eligibility criteria**, select if the discount should apply to specific or all carts.
     1. If you selected **Apply to specific items** earlier, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators.md#predicate-syntax).
  3. Enter the values for the following fields:
     - **When customers buy**: the quantity of line items a Customer must buy for the discount to apply.
     - **line items, they get**: the quantity of line items the discount applies to.
     - From the drop-down, select if the discount should apply to the most expensive item or cheapest item in the cart.
     - **Limit this discount to**: the number of times the discount can apply on a Cart. Select the **Unlimited** checkbox for unlimited use.
  4. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Shipping

- In the **Apply these discount effects** section, choose the target of the discount and define the effects for it.

  1. For **Apply this effect to**, select **Shipping**.
  2. For **Discount type**, select how the discount applies.
  3. For **Discount value**, enter the discount value.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

#### Gift item

- In the **Apply these discount effects** section, select the gift item to add to the Cart.

  1. For **Product ID**, enter the ID of the Product.

     You can find this in the URL, when you select the Product in the Merchant Center.

  2. For **Variant ID**, enter the ID of the Product Variant.

     You can find this in the URL, when you select the Product Variant in the Merchant Center.

  3. Optional: For **Supply Channel**, select the supply Channel of the Product.

  4. Optional: For **Distribution Channel**, select the distribution Channel of the Product.

* In the **Under these cart conditions** section, define the criteria under which the discount should apply.

  1. For **Eligibility criteria**, select if the discount should apply to specific or all carts.

     1. If you selected **Apply to specific carts**, for the **Where** field, select a rule.

        - If you select **all of these are true**, all rules defined must be true for the Cart Discount to apply.
        - If you select **all of these are not true**, all rules defined must be false for the Cart Discount to apply.
        - If you select **at least one of these are true**, any rule defined must be true for the Cart Discount to apply.
        - If you select **at least one of these are not true**, any rule defined must be false for the Cart Discount to apply.

     2. Define a (predicate) condition or nested conditions. For more information about the syntax, see [Predicate syntax](/api/predicates/predicate-operators#predicate-syntax).

  ![Configuration of a Cart Discount rule](https://docs.commercetools.com/merchant-center/images/discounts/cart-discount-rule.png)

### Manage Cart Discounts

#### Add a Cart Discount to a Discount Group

1. Go to **Discounts > Cart discount list**.
2. Select the Cart Discount that you want to add to a Discount Group.
3. On the **General** tab, in **Discount group**, select the Discount Group you want to assign.
4. Click **Save**.
5. Optional: To verify, navigate back to the Discount Groups list, select the group, and then click **Show discounts** to confirm that the Cart Discount is listed.

You can add only global Cart Discounts (not assigned to a Store) with the following targets to a Discount Group: [Item](/merchant-center/cart-discounts.md#item), [Buy and Get](/merchant-center/cart-discounts.md#buy-and-get), [Discount bundles](/merchant-center/cart-discounts.md#discount-bundles), or [Multibuy](/merchant-center/cart-discounts.md#multibuy).

#### Remove a Cart Discount from a Discount Group

1. Go to **Discounts > Cart discount list**.
2. Select the Discount Group associated with the Cart Discount.
3. Click the remove icon and specify the rank (sort order) of the Cart Discount.
4. Click **Save**.

#### Activate a Cart Discount

1. Go to **Discounts > Cart discount list**.
2. Select the Cart Discount that you want to activate.
3. Click the **Status** toggle.
4. Click **Activate discount** in the dialog.

#### Duplicate a Cart Discount

You can duplicate an existing Cart Discount to save time when setting up a new Cart Discount. To duplicate a Cart Discount, do the following:

1. Go to **Discounts > Cart discount list**.
2. Select the Cart Discount that you want to duplicate.
3. Click **Duplicate cart discount**.
4. Click **Save**.

By default, duplicated Discounts are not activated.

## Discount Groups

A Discount Group is a container for Cart Discounts that controls how the grouped discounts are prioritized. This is useful for managing temporary campaigns or running time-sensitive promotions. For example, you can group seasonal sale promotions into a single Discount Group, and then deactivate all of them at once when the sale ends.

Discount Groups are subject to a [limit](/api/limits.md#discount-groups) in a Project.

You can also create and manage Discount Groups by using the [Discount Groups API](/api/projects/discount-groups.md).

Currently, Discount Groups can be used to group only global Cart Discounts. Users with Store-specific permissions can't access Discount Groups.

### Create a Discount Group

To create a Discount Group, do the following:

1. Go to **Discounts > Cart discount list**.
2. Click **Add discount group**.
3. For **Group name**, enter localized names for the Discount Group.
4. Optional: For **Group description**, enter localized descriptions for the Discount Group.
5. For **Group key**, enter a unique identifier value for the Discount Group.
6. For **Rank (sortOrder)**, enter the rank for the Discount Group. The sort order is unique among all Discount Groups and Cart Discounts.
   It determines the priority in which Cart Discounts from the Discount Group are applied; a larger value is ranked higher.
7. Click **Save**.

Currently, only the **Best deal** prioritization mode is supported in the Merchant Center.

### Manage Discount Groups

#### Activate or deactivate a Discount Group

1. Go to **Discounts > Cart discount list**.
2. Select the Discount Groups.
3. Click the **Actions** list.
4. Click either **Activate** or **Deactivate**, and then confirm the action.

Activating a Discount Group does not activate the associated Cart Discounts. Deactivating a Discount Group deactivates all the associated Cart Discounts.

## Related pages

- [Area overview page with navigation](/merchant-center.md)
- [Previous page: Product Discounts](/merchant-center/product-discounts.md)
- [Next page: Discount Codes](/merchant-center/discount-codes.md)