Documentation Commerce Merchandising and Promotions

Create a cart price rule

Last update: March 10, 2025

CREATED FOR:

Beginner
Intermediate
Admin
Leader
User

Complete the following steps to add a rule, describe the conditions, and define the actions. Also complete the labels and test the rule. Price rule conditions can be based on cart or product attributes or Real-Time CDP Audiences, but not on customizable options.

Step 1: Add a rule

On the Admin sidebar, go to Marketing > Promotions > Cart Price Rules.
Click Add New Rule and do the following:
- Under Rule Information, complete the Rule Name and Description.
- If you do not want the rule to go into effect immediately, set Active to No.
To establish the scope of the rule, do the following:
- Select the Websites where the promotion is to be available.
- Select the Customer Groups to which the promotion applies.
  
  If you want the promotion to be available only to registered customers, do not choose the NOT LOGGED IN option.

Set the rule to apply with or without a coupon as follows:

To have the cart rule applied without the use of a coupon code, set Coupon to No Coupon and skip to step 5.

To associate a coupon with a price rule, set Coupon to Specific Coupon and do the following:

Enter a free-text Coupon Code that the customer must enter to receive the discount.
To set a limit on the number of times the coupon can be used, complete the following options:

Option	Description
`Uses per Coupon`	Determines how many times that the coupon code can be used. If there is no limit, leave the field blank.
`Uses per Customer`	Determines how many times that the cart price rule can be used by the same registered customer who belongs to any of the selected customer groups. The setting does not apply to guest shoppers who are members of the NOT LOGGED IN customer group, or to customers who shop without logging in to their accounts. If there is no limit, leave the field blank.

To learn more, see Coupon Codes.

Cart price rule - coupon settings

(Magento Open Source only) Use the Calendar ( ) to choose the From and To date range for the promotion.

Enter a number to define the Priority of this price rule in relation to the Action settings of other price rules which are active at the same time.

NOTE
The Priority setting is important when two cart rules or coupon codes are valid for the same product at the same time. The rule with the highest Priority setting controlling the cart action. Priorities from the highest to the lowest are 0,1,2,3.... See Discard Subsequent Price Rules in the Define the Actions step.

NOTE
Cart price rules that have the same priority do not result in a combined discount. Each rule (coupon) is applied to matching products separately, one-by-one, according to the cart price rule ID in the database. To control the order in which discounts are applied, Adobe recommends setting a different priority for each added cart price rule.
To apply the rule to published RSS feeds, set Public In RSS Feed to Yes.
Click Save and Continue Edit.
- (Magento Open Source only) After the rule is saved, the name of the cart price rule appears at the top of the page.
- (Adobe Commerce only) After the rule is saved, the name of the cart price rule and the Scheduled Changes box appears at the top of the page.

Step 2: Describe the conditions

In this step, the conditions are described that must be met for an order to qualify for the promotion. The rule goes into action whenever the set of conditions is met.

If you are using audiences from Real-Time CDP, skip to this section.

NOTE

The cart price rule is applied to each product in the shopping cart whenever the set of conditions in the Conditions tab is met. Add conditions in the Actions tab to limit the number of products affected by the cart price rule.

NOTE

If at least one conditional product attribute has an empty value, the cart price rule is not applied to the product.

In the left panel, select Conditions.

The first condition appears by default, and states:

If **ALL** of these conditions are **TRUE**:

The statement has two bold links that you can click to display the selection of options for that part of the statement. You can create different conditions by changing the combination of these values. Do any of the following:
- Click ALL and select ALL or ANY.
- Click TRUE and select TRUE or FALSE.
- Leave the condition unchanged to apply the rule to all products.
Click Add ( ) at the beginning of the next line and select an option for the condition, such as cart attribute, product subselection, or combination.

For this example, complete the next part of the condition as follows:
- When prompted to Choose the condition to add, choose Products Subselection.
- In the condition statement, click total quantity and select total quantity or total amount.
IMPORTANT
Total amount is a row total, so taxes are not included into the total amount for the Products Subselection cart price rule condition. Use the Subtotal (Incl. Tax) condition to include taxes.
- In the condition statement, click is and select greater than.
When the next part of the condition appears, click the elements of the statement so you can see where each link with variable values is located.
Click the “more” (…) link, and enter 100.

This condition requires the total quantity of the cart to be 101 or greater.
Click Add ( ) at the beginning of the next line, and then add a condition that is based on Category.
In the next part of the condition, click the more (…) link to display the input field, and then open the Chooser ( ) to display the category tree.
Select the checkbox of the category that you want to use as a condition for the price rule and click the icon to accept the category selections.

The condition can be based on any category that is a child of the store’s root category.
To add more conditions, click Add ( ) and define another condition.

You can repeat the process as many times as needed to describe the conditions that must be met for the price rule. Here are some examples:

Example 1: Regional Price Rule

To create a regional price rule, use one of the following cart attributes:
- Shipping Postcode
- Shipping Region
- Shipping State/Province
- Shipping Country
Example 2: Shopping Cart Totals

To base the condition on shopping cart totals, use one of the following cart attributes:
- Subtotal
- Total Items Quantity
- Total Weight

NOTE

In a case of multiple parallel promotions, the Subtotal condition is applied to the base shopping cart subtotal before any discounts.

IMPORTANT

For purchase orders only: When a cart price rule is set based on one or more specific payment methods, the discount is applied to the total when a purchase order is created. After the purchase order is created, the discount remains applied to the total if the payment method is changed to one that is not covered by the cart price rule.

Add a product attribute to cart price rules

Go to Stores > Attributes > Product and open the product attribute.
In the left panel, select Storefront Properties.
Set Use for Promo Rule Conditions to Yes.
Click Save Attribute.
Go to Marketing > Cart Price Rules and open the required cart price rule.
Expand the Condition section and select Product attribute combination.
Set this condition to one of the following values:
- Click FOUND and select FOUND or NOT FOUND.
- Click ALL and select ALL or ANY.
Click the Add ( ) icon and select the Product Attribute that you set up for promotional rule conditions.
Click Save.

NOTE

When using the is not one of condition with a SKU product attribute and configurable product, both the parent and child product SKUs must be selected. To avoid listing all child SKUs in the rule, you can use the does not contain condition with common SKU parts of a configurable product and its child products.

Use Real-Time CDP audiences to set a condition

You can set a condition for a cart price rule based on a Real-Time CDP audience.

Expand Conditions, click the “+” icon, and select Real-Time CDP Audience from the list.
Select the More (…) icon, click Open Chooser, and view all available Real-Time CDP audiences.

Select the Real-Time CDP audience you want to use for the cart price rule.

Option	Description
`ID`	An internal identifier of the audience used within the Admin
`Real-Time CDP Audience ID`	Unique identifier of the audience when it was created in Experience Platform
`Name`	Name of the audience, such as `Orders over $50`
`Description`	Description of the audience, such as `People who placed an order over $50 in the last month.`.
`Source`	Indicates where the audience came from, such as `Experience Platform`.
`Website`	Indicates which website you have linked to the datastream that contains the audiences. You create this link when you connect your Commerce instance to the Experience Platform through the Data Connection extension.

In the next step, you define the action to occur when the condition is met.

Step 3: Define the actions

The shopping cart price rule actions describe how prices are updated when the conditions are met.

Scroll down to Actions, and expand the section.
Set Apply to one of the following discount options:

Option
Description
Percent of product price discount
Discounts item by subtracting a percentage from the original price. The discount applies to each qualifying item in the cart. For example: Enter 10 in Discount Amount for an updated price that is 10% less than the original price.
Fixed amount discount
Discounts item by subtracting a fixed amount from the original price of each qualifying item in the cart. For example: Enter 10 in Discount Amount for an updated price that is $10 less than the original price.
Fixed amount discount for whole cart
Discounts the entire cart by subtracting a fixed amount from the cart total. For example: Enter 10 in Discount Amount to subtract $10 from the cart total. By default, the discount applies only to the cart subtotal. To apply the discount to the subtotal and shipping separately, use the Apply to Shipping Amount option.
Buy X get Y free
Defines a quantity X that the customer must purchase to receive a quantity Y of the same product/variation for free. (The Discount Amount is Y.) A total quantity of X+Y of that same item must be present in/added to the cart for the discount to be applied.
- Enter the Discount Amount as a number, without symbols. For example, depending on the discount option selected, the number 10 might indicate a percentage, a fixed amount, or a quantity of items.
- For a Buy X get Y Free discount, enter the quantity in the Discount Qty Step (Buy X) field of a single product/SKU/line item that the customer must purchase to receive the discount on the Y quantity. Both X and Y refer to quantities of the same SKU, and that specific quantity (variations of a configurable products are counted separately) of the item must be added to the cart manually.
- In the Maximum Qty Discount is Applied To field, enter the maximum quantity of the same product that can qualify for the discount in the same purchase.
- Set Apply to Shipping Amount ( ) as follows:
  
  Option
  Description
  Yes
  Applies the discount amount separately to the subtotal and shipping amounts.
  No
  Applies the discount amount only to the subtotal.
- To stop processing other rules after this rule is applied, set Discard Subsequent Rules ( ) to Yes. This setting prevents multiple discounts from being applied to the same product.
  
  Option
  Description
  Yes
  Prevents any other pricing rules that may apply to a product from being applied. When multiple pricing rules apply to the same product, only the pricing rule with the highest defined priority (in a rule Priority field) is applied to the qualifying product. This prevents multiple pricing rules from stacking and providing unintended additional discounts.
  No
  Allows multiple pricing rules to apply to the same product. This could result in stacking and providing multiple discounts applied to your listing price.
  
  IMPORTANT
  To discard subsequent rules, a pricing rule must use the defined priorities that are set in the Priority field of each rule, and multiple rules should not have the same priority defined . See Priority in the Add a New Rule step.
To define the exact products in the shopping cart that are affected by the cart price rule, add the additional conditions that are needed for the action.

To determine if free shipping is applied to orders that meet the conditions, set Free Shipping to one of the following:

Option
Description
No
Free shipping is not available.
For matching items only
Free shipping is available only for items that match the conditions of the rule.
For shipment with matching items
Free shipping is available for any shipment that includes matching items. The Free Shipping delivery method must be enabled to use this option.
(Adobe Commerce only) For Add Rewards Points, enter the fixed number of points the customer earns once per order whenever the cart price rule is applied.

If reward points are not enabled, leave this field blank.
When complete, click Save and Continue Edit.

Step 4: Complete the labels

The label appears in the totals section of the order to identify the discount. The label text is enclosed in parentheses, after the word Discount. You can enter a default label for all store views, or enter a different label for each view.

Storefront cart - discount labels

Scroll down to Labels, and expand the section.
Enter the text that you want used as the Default Rule Label for All Store Views.
If your store has multiple views, or multiple websites with multiple views, enter the appropriate label text for each.

For example, if each store view is in a different language, enter the translation of the label for each view.

Exclusive feature only in Adobe Commerce (Learn more)

Dynamic Blocks that are associated with the rule appear in the storefront whenever the conditions are met.

Expand the Related Dynamic Blocks section.
Use the search filters to locate the blocks that you want to associate with the rule.
Select the checkbox in the first column to associate the block with the rule.

To learn more, see Dynamic Blocks in Price Rules.

Step 6: Save and test the rule

When complete, click Save Rule.
Test the rule to make sure that it works correctly.

Price rules are automatically processed with other system rules each night. When you create a price rule, allow enough time for it to get into the system. Also test the rule to make sure that it works correctly. As new rules are added, Commerce recalculates the prices and the priorities accordingly.

Cart price rule demo

Watch this video to learn about creating cart price rules:

video poster

https://video.tv.adobe.com/v/343835?quality=12&learn=on

Field descriptions

Rule Information

Field

Description

Rule Name

(Required) The name of the rule is for internal reference.

Description

A description of the rule should include the purpose of the rule, and explain how it is used.

Active

(Required) Determines if the rule is active in the store. Options: Yes / No

Websites

(Required) Identifies the websites where the rule can be used.

Customer Groups

(Required) Identifies the customer groups to which the rule applies.

Coupon

(Required) Indicates if a coupon is associated with the rule. Options:
No Coupon - No coupon is associated with the rule.
Specific Coupon - A specific coupon is associated with the rule.
Coupon Code - When prompted, enter the Coupon Code that the customer must enter to take advantage of the promotion.
Use Auto Generation - Select the checkbox to automatically generate multiple coupon codes that can be used with the promotion.
Auto - Displays the Manage Coupon Codes section to define the format of the coupon codes to be generated.

Uses per Coupon

Determines how many times that the coupon code can be used. If there is no limit, leave the field blank.

Uses per Customer

Determines how many times that the cart price rule can be used by the same registered customer who belongs to any selected customer group. Does not apply to guest shoppers who are members of the NOT LOGGED IN customer group, or to customers who shop without logging in to their accounts. For no limit, leave blank.

Priority

A number that indicates the priority of this rule in relation to others. Priorities from the highest to the lowest are 0,1,2,3...

Public in RSS Feed

Determines if the promotion is included in your store’s public RSS feed. Options: Yes / No

From

(Magento Open Source only) The first date the coupon can be used.

To

(Magento Open Source only) The last date the coupon can be used.

Conditions

Specifies the conditions that must be met before the cart price rule goes into action. If left blank, the rule applies to all products in the cart. Conditions can be based on any combination of cart and product attributes. However, customizable options cannot be referenced in cart price rule conditions.

Field

Description

Cart Item Attribute

Price in cart

Product price. The rule applies if the product price in cart condition is met.

Quantity in cart

Product quantity. The rule applies if the product quantity in cart condition is met.

Row total in cart

Product row total. The rule applies if the product row total in cart condition is met.

Product Attribute

Attribute Set

Product attribute set. The rule applies if the product meets the product attribute condition.

Category/Other attribute

Product category/other attribute. The rule applies if either the product itself or children meets the category/other attribute condition. The attribute must have Use for Promo Rule Conditions set to Yes.

Category/Other attribute (Children Only)

Child product category/other attribute. The rule applies if only the product children meet the category/other attribute condition (the product itself is not checked here). The attribute must have Use for Promo Rule Conditions to Yes.

Category/Other attribute (Parent Only)

Parent product category/other attribute. The rule applies if only the product itself meets the category/other attribute condition (children products are not checked here). The attribute must have Use for Promo Rule Conditions set to Yes.

Cart Attribute

Subtotal (Excl. Tax)

Cart subtotal (excluding tax). The rule applies if the shopping cart meets the subtotal (excluding tax) condition.

Subtotal (Incl. Tax)

Cart subtotal (including tax). The rule applies if the shopping cart meets the subtotal (including tax) condition.

Subtotal

Cart subtotal. The rule applies if the shopping cart meets a subtotal condition. Check includes or excludes tax according to the current tax settings.

Total Items Quantity

Total quantity of all products in the shopping cart. The rule applies if the shopping cart meets a total items quantity condition.

Total Weight

Total weight of all products in the shopping cart. The rule applies if the shopping cart meets the total weight condition.

Payment Method

Payment method selected on checkout. The rule applies if the payment method condition is met.

Shipping Method

Shipping method selected on checkout. The rule applies if the shipping method condition is met.

Shipping Postcode

Shipping address postcode. The rule applies if the shipping address meets the postcode condition.

Shipping Region

Shipping address region. The rule applies if the shipping address meets the region condition.

Shipping State/Province

Shipping address state/province. The rule applies if the shipping address meets the state/province condition.

Shipping Country

Shipping address country. The rule applies if the shipping address meets the country condition.

Customer Segment

The rule applies if a registered or guest customer meets the customer segment condition.

Actions

Field

Description

Apply

Determines the type of calculation that is applied to the purchase. Options:
Percent of product price discount - Discounts item by subtracting a percentage from the original price. For example: Enter 10 in Discount Amount for an updated price that is 10% less than the original price.
Fixed amount discount - Discounts item by subtracting a fixed amount from the original price of each qualifying item in the cart. For example: Enter 10 in Discount Amount for an updated price that is $10 less than the original price.
Fixed amount discount for whole cart - Discounts the entire cart by subtracting a fixed amount from the cart subtotal. For example: Enter 10 in Discount Amount to subtract $10 from the cart subtotal. By default, the discount applies only to the cart subtotal. To apply the discount to the subtotal and shipping separately, see Apply to Shipping Amount.
Buy X Get Y Free (discount amount is Y) - Defines a quantity that the customer must purchase to receive a quantity for free. (The Discount Amount is Y.)

Discount Amount

(Required) The amount of discount that is offered.

Maximum Qty Discount is Applied To

Sets the maximum number of products that the discount can be applied to in the same purchase.

Discount Qty Step (Buy X)

Sets the number of products represented by X in a Buy X Get Y Free promotion. Also, defines how many products must be added to the cart together in batches to apply Fixed amount discount and Percent of product price discount promotions.

Apply to Shipping Amount

Determines if the discount is applied separately to the subtotal and shipping amounts. Otherwise, it is applied only to the subtotal. Options: Yes / No

Discard Subsequent Rules

Determines if lower priority rules (1 is the highest priority) can be applied to the product when this cart price rule is a match. Enable this option to prevent multiple discounts from being applied to the same product. Options: Yes / No

Free Shipping

Determines if free shipping is included in the promotion, and if so, for which items. Options:
No - Free shipping is not available for the current rule.
For matching items only - Free shipping is available only for specific items in the cart that match the rule.
For shipment with matching items - Free shipping is available for all items in the cart. The Free Shipping delivery method must be enabled to use this option.

Add Reward Points

(Adobe Commerce only) Specifies the number of reward points that are earned by the customer whenever the price rule is applied.

Labels

Field

Description

Default Rule Label for All Store Views

A default label that identifies the discount and can be used for all store views.

Store View Specific Labels

If applicable, specifies a different label to identify the discount for each store view.

Exclusive feature only in Adobe Commerce (Learn more)

Identifies any dynamic blocks that are associated with the rule.

recommendation-more-help

Create a cart price rule

Step 1: Add a rule

Step 2: Describe the conditions

Add a product attribute to cart price rules

Use Real-Time CDP audiences to set a condition

Step 3: Define the actions

Step 4: Complete the labels

Step 5: Add related dynamic blocks (optional)

Step 6: Save and test the rule

Cart price rule demo

Field descriptions

Rule Information

Conditions

Actions

Labels

Related Dynamic Blocks