Cart Discounts and Discount Groups

Managing Discounts applied to a Customer's Cart

Ask about this Page
Copy for LLM
View as Markdown
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 in a Project.
Learn more about Cart Discounts in our self-paced Cart Discounts 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, Buy and Get, Discount bundles, and 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 for further instructions.
    • To discount items in a cart, see Item for further instructions.
    • To offer discounts such as "Buy one, Get one (BOGO)", see Buy and Get for further instructions.
    • To group related products together and sell them at a combined (often discounted) price, see Discount bundles for further instructions.
    • To offer free or discounted shipping cost for a cart, see Shipping for further instructions.
    • To add a gift item to a cart with a purchase, see 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 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.
    Configuration of a Cart Discount rule

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.
    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.
    Configuration of a Cart Discount rule

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.
    Configuration of a Cart Discount rule

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.
    Configuration of a Cart Discount rule

Multibuy

For a more powerful and flexible solution, use the Buy and Get or Discount bundles.
Multibuy discount target is available in public beta on the Cart Discounts API.
  • 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.
    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.
    Configuration of a Cart Discount rule

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.
    Configuration of a Cart Discount rule

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.
    Configuration of a Cart Discount rule

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) and non-gift item Cart Discounts to a Discount Group.

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 in a Project.
You can also create and manage Discount Groups by using the Discount Groups API.

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.