Documentation

Creating Discounts

Learn how to define discounts with the Merchant Center.

Discount templates let you create simple promotions from a predefined rule structure. Depending on the template selected, the fields available on the discount creation form (that are not required for the use case) are made available. This lets you focus on the essential settings and create your promotions faster.

This tutorial shows you how you can create a simple product or cart discount with discount templates.

Create a Product Discount

For this tutorial, consider an example of a merchant selling furniture in the United States. In their web shop, the products sold are categorized into Living Room Furniture and Bedroom Furniture. The goal is to discount all products in the Bedroom Furniture Category by 10%.

  1. In the Merchant Center main menu, go to Discounts > Add discount.

  2. In the Discount templates card, select Percent off product in the Product discounts section of the drop-down, and then click Select template.

  3. In the General Information section, follow these steps:

    1. For Product discount name, enter a display name for the Product Discount, 10% off Bedroom Furniture.
    2. Optional: For Product discount description, enter a plain-text description for the Product Discount, 10% off Bedroom Furniture.
    3. Optional: For Product discount key, enter a unique identifier key for the Product Discount, 10pctOffBedroomFurniture.
    4. For Discount value, enter 10. This is the percentage value by which targeted products will be discounted.
    5. For Rank (sortOrder), enter 0.7. This defines the relative importance of the Product Discount. Since a larger value ranks higher and as Product Discounts do not stack, this discount will be considered and applied to products instead of an active Product Discount with a rank of 0.3.

  4. In the Product discount rules, follow these steps:

    1. For operation, select This discount only applies to products.
    2. For condition, select If ALL of the following conditions are met.
      • Select Categories (by key), then is, and then enter bedroom-furniture (the Category key of Bedroom Furniture).

  5. Click Save. New discounts are not active by default; click the Status toggle to activate the Discount.

You have now successfully created a percentage off discount. All products in the Bedroom Furniture Category would now display the newly discounted price against the base price.

Create a Cart Discount

Fixed amount off based on total spend

For this tutorial, let's consider the same example of the merchant selling furniture. The goal is to discount any cart by $10 if the cart's value is $100 or more, and no more discounts must apply to the cart.

  1. In the Merchant Center main menu, go to Discounts > Add discount.

  2. In the Discount templates card, select Amount off based on total spend in the Cart discounts with line items section of the drop-down, and then click Select template.

  3. In the General Information section, follow these steps:

    1. For Cart discount name, enter a display name for the Cart Discount, $10 off when you spend $100.

    2. Optional: For Cart discount description, enter a plain-text description for the Cart Discount, $10 off when you spend $100.

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

    4. For Rank (sortOrder), enter 0.5. This defines the relative importance of the Cart Discount; a larger value ranks higher.

      • Select the Do not apply any further cart discounts after this one checkbox. This ensures that no further discounts apply to the cart after this discount.

  4. In the Discount configurations section, follow these steps:

    1. In the Under these cart conditions section, do the following:

      1. For operation, select This discount only applies to carts.
      2. For condition, select If ALL of the following conditions are met.
        • Select Cart Total, then is equal to or greater than, and then enter 100.00 USD.

    2. In the Apply these discount effects, do the following:

      1. For Discount value, enter 10.00 for the USD currency.
      2. For Target predicate, select This discount applies to all line items without restriction.

  5. Click Save. New discounts are not active by default; click the Status toggle to activate the Discount.

You have now successfully created a fixed amount off discount. When a cart value reaches $100 and more, the cart would now be discounted by $10.

Buy 2 jeans and 1 shirt, get $100 off across the bundle

For this tutorial, let's consider an example of a merchant selling clothes in the United States. The goal is to apply a $100 discount (spread evenly) across the bundle items (2 jeans and 1 shirt) in the cart. The discount will apply to the cheapest items, up to 3 times.

  1. In the Merchant Center main menu, go to Discounts > Add discount.

  2. In the Cart discount card, select Add cart discount.

  3. In the General Information section, follow these steps:

    1. For Cart discount name, enter a display name for the Cart Discount. For example, $100 off across the bundle.
    2. Optional: For Cart discount description, enter a plain-text description for the Cart Discount. For example, Buy 2 jeans and 1 shirt, Get $100 off across the bundle.
    3. Optional: For Cart discount key, enter a unique identifier key for the Cart Discount. For example, USD100offCartBundle.
    4. For Rank (sortOrder), enter 0.5. This defines the relative importance of the Cart Discount; a larger value ranks higher.

  4. In the Discount configurations section, follow these steps:

    1. In the Under these cart conditions section, for Eligibility criteria, select Apply to all carts.

    2. In the Apply these discount effects section, select Buy and Get.

    3. In the Each time when cart contains section, follow these steps

      1. Select Specific items.
      2. For Item Criteria, select Categories as the predicate.
      3. From the next drop-down, select the operator as is.
      4. Enter the category as Jeans.
      5. For Count, select the operator as is equal to and enter the value as 2.
      6. Click Line item Criteria.
      7. For Item Criteria, select Categories as the predicate.
      8. From the next drop-down, select the operator as is.
      9. Enter the category as Shirts.
      10. For Count, select the operator as is equal to and enter the value as 1.

    4. In the Apply Discount on section, follow these steps:

      1. Select Apply to specific items.
      2. For Item Criteria, select Categories as the predicate.
      3. From the next drop-down, select the operator as is.
      4. Enter the category as Jeans.
      5. For Count, select the operator as is equal to and enter the value as 2.
      6. For Exclude, enter the value as 0.
      7. Click Line item Criteria.
      8. For Item Criteria, select Categories as the predicate.
      9. From the next drop-down, select the operator as is.
      10. Enter the category as Shirts.
      11. For Count, select the operator as is equal to and enter the value as 1.
      12. For Exclude, enter the value as 0.

    5. In the Apply On section, select Cheapest items.

    6. In the Allow multiple application within an order section, select specify times and then enter 3.

    7. In the Discount type section, follow these steps:

      1. Select Absolute Value.
      2. Select Distributed evenly across all eligible items.
      3. For Discount Value, enter 100.

  5. Click Save. New discounts are not active by default; click the Status toggle to activate the Discount.

You have now successfully created a Buy and Get discount. The following examples highlight how the discount applies in different scenarios:

  • If a cart contains 1 shirt and 4 jeans, no item will be discounted because the first criterion is not met.
  • If a cart contains 4 shirts, no item will be discounted because the second criterion is not fulfilled.
  • If a cart contains 2 shirts and 3 jeans, one bundle of 1 shirt and 2 jeans will be discounted (the cheapest ones), and the bundle will be priced at $100.
  • If a cart contains 5 shirts and 6 jeans, three bundles of 1 shirt and 2 jeans will be discounted. Every time the target pattern is matched, the cheapest bundle is selected with each bundle priced at $100.
  • If a cart contains 4 shirts and 12 jeans, three bundles of 1 shirt and 2 jeans will be discounted because this discount can be applied for a maximum of 3 times.

Buy 2 jeans, get up to 3 shirts at 20% off

For this tutorial, let's consider the same example of the merchant selling clothes. The goal is to offer a discount of 20% on up to 3 shirts when 2 jeans are added to the cart. The discount will apply to the most expensive items, up to 4 times.

  1. In the Merchant Center main menu, go to Discounts > Add discount.

  2. In the Cart discount card, select Add cart discount.

  3. In the General Information section, follow these steps:

    1. For Cart discount name, enter a display name for the Cart Discount. For example, Get up to 3 shirts at 20% off.
    2. Optional: For Cart discount description, enter a plain-text description for the Cart Discount. For example, Buy 2 jeans, Get up to 3 shirts at 20% off.
    3. Optional: For Cart discount key, enter a unique identifier key for the Cart Discount. For example, Upto3Shirts20%off.
    4. For Rank (sortOrder), enter 0.5. This defines the relative importance of the Cart Discount; a larger value ranks higher.

  4. In the Discount configurations section, follow these steps:

    1. In the Under these cart conditions section, for Eligibility criteria, select Apply to all carts.

    2. In the Apply these discount effects section, select Buy and Get.

    3. In the Each time when cart contains section, follow these steps:

      1. Select Specific items.
      2. For Item Criteria, select Categories as the predicate.
      3. From the next drop-down, select the operator as is.
      4. Enter the category as Jeans.
      5. For Count, select the operator as is equal to and enter the value as 2.

    4. In the Apply Discount on section, follow these steps:

      1. Select Apply to specific items.
      2. For Item Criteria, select Categories as the predicate.
      3. From the next drop-down, select the operator as is.
      4. Enter the category as Shirts.
      5. For Count, select the operator as is up to and enter the Count value as 3.
      6. For Exclude, enter the value as 0.

    5. In the Apply On section, select Most expensive items.

    6. In the Allow multiple application within an order section, select specify times and then enter 4.

    7. In the Discount type section, follow these steps:

      1. Select Percentage off.
      2. For Discount Value, enter 20.

  5. Click Save. New discounts are not active by default; click the Status toggle to activate the Discount.

You have now successfully created a Buy and Get discount. The following examples highlight how the discount applies in different scenarios:

  • If a cart contains 2 jeans and 8 shirts, 3 shirts (the most expensive ones) will be discounted because the trigger is matched only once.
  • If a cart contains 4 jeans and 3 shirts, all 3 shirts will be discounted because although the trigger is matched twice, the target is met only once.
  • If a cart contains 4 jeans and 5 shirts, all 5 shirts will be discounted from two discount applications because the trigger is matched twice and the target is also met twice.
  • If a cart contains 6 jeans and 6 shirts, all 6 shirts will be discounted from two discount applications because the trigger is matched twice and the target is also met twice.
  • If a cart contains 20 jeans and 20 shirts, 12 shirts (the most expensive ones) will be discounted because this discount can be applied for a maximum of 4 times.

Buy 3 t-shirts, get the next 2 t-shirts at $20 each

For this tutorial, let's consider the same example of the merchant selling clothes. The goal is to offer up to 2 t-shirts at $20 each when 3 t-shirts are added to the cart. The discount will apply to the cheapest items.

  1. In the Merchant Center main menu, go to Discounts > Add discount.

  2. In the Cart discount card, select Add cart discount.

  3. In the General Information section, follow these steps:

    1. For Cart discount name, enter a display name for the Cart Discount. For example, Get next 2 t-shirts at $20 each.
    2. Optional: For Cart discount description, enter a plain-text description for the Cart Discount. For example, Buy 3 t-shirts, Get the next 2 t-shirts at $20 each.
    3. Optional: For Cart discount key, enter a unique identifier key for the Cart Discount. For example, 2TShirtsUSD20each.
    4. For Rank (sortOrder), enter 0.5. This defines the relative importance of the Cart Discount; a larger value ranks higher.

  4. In the Discount configurations section, follow these steps:

    1. In the Under these cart conditions section, for Eligibility criteria, select Apply to all carts.

    2. In the Apply these discount effects section, select Buy and Get.

    3. In the Each time when cart contains section, select Specific items and then follow these steps:

      1. For Item Criteria, select Categories as the predicate.
      2. From the next drop-down, select the operator as is.
      3. Enter the category as T-shirts.
      4. For Count, select the operator as is equal to and enter the value as 3.

    4. In the Apply Discount on section, follow these steps:

      1. Select Apply to specific items.
      2. For Item Criteria, select Categories as the predicate.
      3. From the next drop-down, select the operator as is.
      4. Enter the category as T-shirts.
      5. For Count, select the operator as is up to and enter the value as 2.
      6. For Exclude, enter the value as 3.

    5. In the Apply On section, select Cheapest items.

    6. In the Allow multiple application within an order section, select unlimited times.

    7. In the Discount type section, follow these steps:

      1. Select Amount off.
      2. For This will be, select applied individually to each eligible item.
      3. For Discount Value, enter 20.

  5. Click Save. New discounts are not active by default; click the Status toggle to activate the Discount.

You have now successfully created a Buy and Get discount. The following examples highlight how the discount applies in different scenarios:

  • If a cart contains 3 t-shirts, no t-shirt will be discounted because the trigger is not matched.
  • If a cart contains 4 t-shirts, 1 t-shirt will be discounted from one discount application because the trigger is matched once.
  • If a cart contains 5 t-shirts, 2 t-shirts will be discounted from one discount application because the trigger is matched once.
  • If a cart contains 8 t-shirts, 2 t-shirts will be discounted from two discount applications. Although the trigger is matched twice, both the discounted t-shirts will be included as part of the first trigger. The remaining 3 t-shirts match the second trigger, but there are no other t-shirts available in the cart to be discounted.
  • If a cart contains 9 t-shirts, 3 t-shirts will be discounted from two discount applications because the trigger is matched twice. 2 discounted t-shirts will be included as part of the first trigger. And 1 discounted t-shirt will be included as part of the second trigger.