Cart Discounts

Elevate, May 20-22-2025, Miami Beach, Florida

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
The number of active Cart Discounts in a Discount Code is limited to 10.
The number of active Cart Discounts that do not require a Discount Code is limited to 100. For Stores, the number of active Cart Discounts that do not require a Discount Code is limited to 100. Thus, the overall limit of active Cart Discounts that do not require a Discount Code is 100+(100*number of Stores in a Project).

Create a Cart Discount

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

Total price

To create a Cart Discount that targets the total price of the Cart, do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.

      If other Cart Discounts with different effects apply on a Cart, this discount applies last—regardless of its sort order and the stacking setting of the other Cart Discounts.

      The sort order of this discount only determines its ranking among other similar Cart Discounts (targeting the Total Price). As a result, when the Do not apply any further cart discounts after this one checkbox is selected, the application of further discounts is ignored only when there are other Cart Discounts targeting the Total Price (with a lower sort order).
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount and define the effects for it.
    • For Apply this effect to, select Total Price.
    • For Discount type, select how the total Price of the Cart will be discounted.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
      Configuration of a Cart Discount rule
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Item

To create a Cart Discount that targets the (Custom) Line Items in a Cart, do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount, items eligible for the discount, and define the effects for it.
    • For Apply this effect to, select Item.
    • For Eligibility criteria, if you select Apply to specific carts, define the target of the Cart Discount.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
      Configuration of a Cart Discount rule
    • For Discount type, select how the items in the Cart will be discounted.
    • If you selected Amount off in the earlier step, select how to apply the Discount on items in the Cart.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Buy and Get

To create a Cart Discount to offer deals such as "Buy one, Get one (BOGO)", do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount, eligible items for the discount (to trigger), and define the effects for it.
    • For Apply this effect to, select Buy and Get.
    • Choose if specific or all items of a Cart must be considered for the Discount to trigger.
      • For Count, select the condition from the drop-down and enter the count.
        If you selected, Specific items earlier, define the criteria for the items to be considered to trigger the discount. You can add more nested conditions.
    • To define what items get discounted, choose if specific or all items of a Cart must be considered for the Discount to trigger.
      • For Count, select the condition from the drop-down and enter the count.
        If you selected, Specific items earlier, define the criteria for the items to be considered to trigger the discount. You can add more nested conditions.
      • Choose if the cheapest or most expensive items of a Cart must be considered for the discount trigger.
    • Define how many times the Cart Discount can apply in an Order.
    • Select how the items in the Cart will be discounted.
    • If you selected Amount off or Fixed price in the earlier step, select how to apply the Discount on items in the Cart.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
      Configuration of a Cart Discount rule
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Discount bundles

To create a Cart Discount that offers related products together at a combined (often discounted) price, do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount, eligible items for the discount, and define the effects for it.
    • For Apply this effect to, select Discount bundles.
    • Choose if you want to consider specific or all items in a Cart for the bundle.
      • For Count, select a rule from the drop-down and enter a count. If you selected Apply to specific items earlier, define the criteria for the items considered for the discount.
      • Choose if the cheapest or most expensive items in a Cart must be considered.
    • Define how many times the discount can apply in an Order.
    • Select how the items in the Cart will be discounted.
    • If you selected Amount off or Fixed price in the earlier step, select how to apply the Discount on items in the Cart.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Multibuy discounts

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.
  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount, eligible items for the discount, and define the effects for it.
    • For Apply this effect to, select Buy and Get and click Mulitbuy in the notification.
    • For Eligibility criteria, if you selected Apply to specific items earlier, define the criteria for the items considered for the discount.
    • Configure the following fields:
      • When customers buy: the total line items (quantity) a Customer must buy before applying the Discount.
      • line items, they get: the quantity of Line Items to apply the Discount to. The Discount can be applied to the following, as selected from the drop-down:
      • The most expensive item or cheapest item
      • % off: automatically populated from the Discount value provided when creating a Cart Discount.
      • Limit this discount to: limits the number of times the Discount can be applied if a value is provided in the Add quantity field. Select the Unlimited checkbox for unlimited use.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Shipping

To create a Cart Discount that targets the shipping cost of a Cart, do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Numeric.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, choose the target of the discount and define the effects for it.
    • For Apply this effect to, select Shipping.
    • For Discount type, select how the shipping cost will be discounted.
    • For Discount value, enter the discount value that will apply.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Gift item

To create a Cart Discount that offers a free gift item with a Cart purchase, do the following:

  1. Go to Discounts > Add discount.
  2. Click Add cart discount.
  3. For Cart discount type, select Gift line item.
  4. In the General Information section, add basic information about the Cart Discount.
    • For Cart discount name, enter localized names for the Cart Discount.
    • Optional: For Cart discount description, enter localized descriptions for the Cart Discount.
    • Optional: For Cart discount key, enter a unique identifier value for the Cart Discount.
    • Optional: For Store, select the Stores for which the Cart Discount can apply.
    • For Rank (sortOrder), enter the rank (a decimal value between 0-1) for the Cart Discount. It determines the importance of the Cart Discount among other Discounts; a larger value is ranked higher.
    • Optional: For Stacking options, select the Do not apply any further cart discounts after this one checkbox if no other Cart Discounts should apply on a Cart after this Discount. Based on the ranking of the Cart Discount, any Cart Discounts with a lower value are ignored.
    • Optional: For Discount code, select Required if the Cart Discount must apply only when a Discount Code is applied to a Cart.
    • Optional: For Valid from, select the date/time from which the Cart Discount is valid.
    • Optional: For Valid until, select the date/time until which the Cart Discount is valid.
  5. In the Apply these discount effects section, select the item you want to add as a gift to the cart.
    • 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.

    • For Variant ID, enter the ID of the Product Variant. It can be found in the Variants tab of a Product.

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

    • Optional: For Supply Channel, select the supply Channel of the Product.
    • Optional: For Distribution Channel, select the distribution Channel of the Product.
  6. In the Under these cart conditions section, if you select Apply to specific carts, define the criteria under which the Cart Discount should apply.
    • 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.
    • Define a (predicate) condition. For more information about syntax, see Predicate syntax. You can also create nested conditions.
  7. Click Save.
By default, new discounts are inactive and must be activated to take effect.

Activate a Cart Discount

To activate a Cart Discount, do the following:

  1. Select the Discount you want to activate.
  2. Click the Status toggle.
  3. Click Activate discount in the dialog.

Duplicate a Cart Discount

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

  1. Select the Discount you want to duplicate.
  2. Click Duplicate cart discount.
  3. Click Save.

By default, duplicated Discounts are not activated.