Promotions

You can manage promotions on the Store > Promotions page.

For a conceptual overview of promotions in Commerce Cloud, see the Promotions section.

Creating Promotions

important

• Line-item discounts are only supported by the line calculation method. For more information about this method and to update the calculation method, see the Calculation Method section.
• You cannot change the promotion type or schema after creating a promotion.
• If you want to restrict the usage of a promotion, do not select the Automatic field in promotion setting and ensure that you create a code for the promotion.

1. Go to Store > Promotions.

2. Click +New Promotion.

3. Enter the the required information to create the following promotions:

   • Cart-level fixed discount promotions
   • Cart-level percentage discount promotions
   • X for Y discount promotions
   • X for amount discount promotions
   • Bundle discount promotions
   • Item fixed discount promotions
   • Item percentage discount Promotions
   • Free gift promotions

important

• We recommend not to use the Maximum discount value setting for the following promotions:

  • Cart-level fixed discount promotions
  • Item fixed discount promotions
  • X for Y discount promotions
  • X for amount discount promotions
  • Bundle discount promotions
  • Free gift promotions

• The Exclude items setting specifies the products to be excluded from the cart-level promotions, such as fixed_discount and percent_discount. However, the stores that use simple calculation method do not support excluding products from promotions.

• Line-item discounts are only supported by the line calculation method. For more information about this method, see the Calculation Method section.

Creating cart-level fixed discount promotions

warning

We recommend not to set maximum discount value for this promotions. Setting maximum discount value for this promotion conflicts with the cart fixed discount value. For example, if the maximum discount value is $10 and the cart fixed discount value is $20, the cart gets $10 discount only.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Fixed discount.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied.
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. In the Define schema section, do the following:
    1. Click Currencies and add the amount and currencies.
    2. Click Save.
    3. Click Exclude items > Specify products and enter the product SKUs that you want to exclude from a cart-level promotion.
    4. Click Save.
12. Click Save

Creating cart-level percentage discount promotions

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Percent discount.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Maximum discount value field, enter the maximum possible discount amount and currency.
12. In the Define schema section, do the following:
    1. Click Currencies and add the amount and currencies.
    2. Click Save.
    3. Click Exclude items > Specify products and enter the product SKUs that you want to exclude from a cart-level promotion.
    4. Click Save.
13. Click Save.

Creating X for Y discount promotions

Use this procedure to create promotions such as, such as 2-for-1 sales. In this promotion, 2 SKU1s are sold for the price of 1. In this example, X is 2 and Y is 1.

warning

We recommend not to set maximum discount value for this promotions. Setting maximum discount value for this promotion conflicts with the promotion settings.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select X for Y.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
12. In the Define schema section, do the following:
    1. Click Specify X/Y values, and add value for X and Y.
    2. Click Save.
    3. Click Add target and enter the SKUs for which you want to apply this promotion.
    4. Click Save.
13. Click Save.

Creating X for amount discount promotions

Use this procedure to create promotions such as, such as 3-for-$20 sales. In this promotion, 3 SKU1s are sold for $20.

warning

We recommend not to set maximum discount value for this promotions. Setting maximum discount value for this promotion conflicts with the promotion settings.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select X for amount.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
12. In the Define schema section, do the following:
    1. Click Add currency and enter the promotion amount and currency.
    2. Click Specify X/Y values, and add value for X.
    3. Click Save.
    4. Click Add target and enter the SKUs for which you want to apply this promotion.
    5. Click Save.
13. Click Save.

Creating bundle discount promotions

warning

We recommend not to set maximum discount value for this promotions. Setting maximum discount value for this promotion conflicts with the promotion settings.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Bundle.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
12. In the Define schema section, do the following:
    1. Click Add currency, and add the amount and currency for the bundle.
    2. Click Save.
    3. Click Add requirement and enter the SKU and quantity of the first item in the bundle.
    4. Click Save.
    5. Repeat step 3 to add more items to the bundle.
    6. Click Save.
13. Click Save.

Example for bundle

For a bundle promotion (SKU1 or SKU2 ) + SKU3 for $20, the promotion is applied if the bundle contains SKU1 and SKU3 or SKU2 and SKU3. Do the following to define schema for this promotion.

1. Click Add requirement and enter SKU1 and SKU2 separated by a comma.
2. Click Save.
3. Click Add requirement again and enter SKU3.
4. Click Save.

Creating item fixed discount promotions

warning

We recommend not to set maximum discount value for this promotions. Setting maximum discount value for this promotion conflicts with the promotion settings.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Item fixed discount.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
12. In the Define schema section, do the following:
    1. Click Add currency, and add the amount and currency.
    2. Click Save.
    3. Click Add target and enter the SKUs that you want to include in the promotion.
    4. Click Save.
13. Click Save.

Creating item percentage discount promotions

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Item percent discount.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Maximum discount value field, enter the maximum possible discount amount and currency.
12. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
13. In the Define schema section, do the following:
    1. Click Add percentage and add the percentage and currency.
    2. Click Save.
    3. Click Add target and enter the SKUs that you want to include in the promotion.
    4. Click Save.
14. Click Save.

Creating free gift promotions

warning

We recommend not to set maximum discount value for this promotions. This setting doesn’t have any affect on the promotion.

1. Go to Store > Promotions.
2. Click +New Promotion.
3. In the Name field, enter a name for the promotion.
4. In the Description field, enter a description for the promotion.
5. In the Start date field, select the start time for the promotion.
6. In the End date field, the end time of the promotion.
7. In the Promotion type field, select Free gift.
8. To enable the promotion, select the Enabled field.
9. To automatically apply the promotion, select the Automatic field. If this field is not selected, the promotion requires the buyer to enter a code in the cart to get the discount. For more information, see the Adding codes section.
10. (Optional) In the Minimum cart value field, click Specify values. The Set minimum cart value window is displayed.
    1. In the Set minimum cart value > Amount field, enter a minimum cart value before the promotion can be applied
    2. In the Select Currency field, select a currency. You can add one or several value specifications in different currencies. For more information about currencies, see the Adding pricing section.
11. (Optional) In the Quantity limit per use field, specify the maximum number of application of a promotion per cart for a single use of a promotion.
12. In the Define schema section, do the following:
    1. Click Product requirements and enter the SKUs and quantity of the items for which a free gift is included.
    2. Click Save.
    3. Click Add gift and enter the SKUs of the free gift items separated by comma.
    4. Click Save.
13. Click Save.

Editing promotions

warning

You cannot change the promotion type or schema after creating a promotion.

1. Go to Store > Promotions.
2. Click the promotion name that you want to edit.
3. Change the settings as required.
4. Click Save.

Adding Codes

After creating a promotion, you can add codes for the promotion. Customers must enter this code to avail the promotion. For the code to work, ensure that the Automatic field in the promotion settings is not selected.

1. Go to Store > Promotions.

2. Click the promotion name for which you want to add a code.

3. In the right pane, click Add a new promotion code.

4. Click one of the following tabs:

   • Add a single code
   • Bulk generate codes

5. Enter the required settings.

6. Click Generate Code.

7. Click Save.

Adding single code

1. Go to Store > Promotions.
2. Click the promotion name for which you want to add a code.
3. In the right pane, click Add a new promotion code.
4. In the Add a single code tab, enter the following details:

• (Optional) Prepend Value : Specifies a prepend value for the code. For example, if you set summer as prepend value for a code 123, the promotion code is summer-123.
• (Optional) Restrict to user : Specifies the customer ID of the users who can use the code.
• (Optional) Usage limit type : Specifies whether the usage limitation is item-level or cart-level. The options are Per Cart and Per Line Item. See Create Promotion Codes on consume_unit.
• (Optional) Usage count : Specifies the maximum the number of usages of a code for a promotion. If you set this value to zero, customers cannot use this promotion. If no value is set, customers can use the code any number of times.
• (Optional) Code : Specifies the code for the promotion. You can either enter the code manually or use a system generated code.

1. Click Generate Code.
2. Click Save.

Generating bulk codes

1. Go to Store > Promotions.
2. Click the promotion name for which you want to add a code.
3. In the right pane, click Add a new promotion code.
4. In the Bulk generate codes tab, enter the following details:

• (Optional) Prepend Value : Specifies a prepend value for the codes. When codes are generated, this prefix is added to each of them.
• Number of codes to generate : Specifies the number of codes to be generated.

1. Click Generate Code.
2. Click Save.

The codes for a promotion are displayed in the details page of the promotion.

note

You can only generate maximum 1000 codes for a single promotion.

Deleting codes

To delete a code, select the code and click the trash icon.

Related Topics

• Promotions
• Customers
• Catalog

API

• Promotions API

How-to guide

• Create and apply promotions