Introduction #
Cart Item Conditions allow you to create promotions based on the products currently in a customer’s cart.
Unlike Cart Conditions, which evaluate the entire cart, Cart Item Conditions focus on specific products, categories, attributes, or tags within the cart.
Cart Item Conditions are commonly used for:
- Product-specific discounts
- Category promotions
- Buy More, Save More offers
- Product bundle campaigns
- BOGO promotions
- Quantity-based rewards
These conditions give you precise control over which cart items qualify for a promotion.
Cart Item Conditions vs Cart Conditions #
Cart Conditions evaluate the entire cart.
Examples:
- Cart Subtotal > $100
- Cart Item Count > 5
- Payment Method = Stripe
Cart Item Conditions evaluate specific products within the cart.
Examples:
- Customer has 3 Hoodies
- Customer has 2 Blue products
- Customer has 5 Featured items
Understanding this difference is important because Cart Item Conditions only count products that match the configured rules.
Available Cart Item Conditions #
Ezhance supports the following Cart Item Conditions:
Products #
Evaluate specific WooCommerce products.
Examples:
- Cap
- Hoodie
- T-Shirt
Categories #
Evaluate products belonging to specific categories.
Examples:
- Hoodies
- Accessories
- Shoes
Attributes #
Evaluate products using WooCommerce attributes.
Examples:
- Color = Blue
- Size = Large
- Material = Cotton
Tags #
Evaluate products using WooCommerce tags.
Examples:
- Featured
- Summer
- Clearance
All Cart Item Conditions use the same quantity evaluation system.
How Cart Item Conditions Work #
Cart Item Conditions follow three steps:
Step 1 #
Identify matching products.
Step 2 #
Calculate the matched quantity.
Step 3 #
Evaluate the quantity requirement.
Only products that match the condition are included in the calculation.
Understanding IN LIST and NOT IN LIST #
Every Cart Item Condition supports two matching modes:
- IN LIST
- NOT IN LIST
These modes determine which products are included in the quantity calculation.
IN LIST #
IN LIST only evaluates products that match the selected items.
Example:
Products IN LIST:
- Cap
Quantity Requirement:
- Greater than or equal to 3
Cart:
- Cap × 2
- Hoodie × 4
Matched Quantity:
2
Result:
Condition fails because only 2 matching Cap products exist.
The Hoodie quantity is ignored because Hoodie is not in the selected list.
NOT IN LIST #
NOT IN LIST evaluates products that do NOT match the selected items.
Example:
Products NOT IN LIST:
- Cap
Quantity Requirement:
- Greater than or equal to 3
Cart:
- Cap × 2
- Hoodie × 4
Matched Quantity:
4
Result:
Condition passes because only non-Cap products are counted.
The Cap quantity is ignored because it belongs to the excluded list.
Understanding Matched Quantity #
Matched Quantity is one of the most important concepts in Ezhance.
Matched Quantity means:
The total quantity of products that satisfy the condition.
Only matching products contribute to the calculation.
Example:
Products IN LIST:
- Cap
- Hoodie
Cart:
- Cap × 2
- Hoodie × 3
- T-Shirt × 5
Matched Quantity:
2 + 3 = 5
Result:
Matched Quantity = 5
The T-Shirt quantity is ignored because it does not match the condition.
Quantity Evaluation Modes #
Ezhance supports two quantity evaluation modes:
- Cumulative Quantity (Default)
- Per Matching Item Quantity
Cumulative Quantity (Default) #
By default, Ezhance combines all matching quantities into a single total.
Example:
Products IN LIST:
- Cap
- Hoodie
Required Quantity:
- Greater than or equal to 5
Cart:
- Cap × 2
- Hoodie × 3
Matched Quantity:
5
Result:
Condition passes.
Because all matching quantities are combined together.
This is the default and recommended behavior for most promotions.
Per Matching Item Quantity #
Enable:
Check quantity per matching item
When enabled, each matching item must satisfy the quantity requirement individually.
Example:
Products IN LIST:
- Cap
- Hoodie
Required Quantity:
- Greater than or equal to 5
Cart:
- Cap × 2
- Hoodie × 3
Result:
Condition fails.
Although the total quantity is 5, neither individual product reaches a quantity of 5.
Cap:
2
Hoodie:
3
Both fail the requirement.
Per Matching Item Example #
Condition:
Products IN LIST:
- Cap
- Hoodie
Quantity:
- Greater than or equal to 3
Check quantity per matching item:
Enabled
Cart:
- Cap × 2
- Hoodie × 3
Result:
Condition passes.
Why?
Cap:
2 → Fail
Hoodie:
3 → Pass
Because at least one matching item satisfies the requirement.
Why Ezhance Uses Matched Quantities #
Many promotion plugins evaluate the entire cart.
Ezhance evaluates only the products that match the configured condition.
This makes promotions much more flexible.
Example:
Condition:
Categories IN LIST:
- Hoodies
Quantity:
- Greater than or equal to 3
Cart:
- Hoodie × 3
- Shoes × 10
Matched Quantity:
3
Result:
Condition passes.
The Shoes quantity is ignored because only Hoodies are being evaluated.
Common Use Cases #
Buy Any 3 Hoodies #
Condition:
Categories IN LIST:
- Hoodies
Quantity:
- Greater than or equal to 3
Buy Any 5 Featured Products #
Condition:
Tags IN LIST:
- Featured
Quantity:
- Greater than or equal to 5
Reward Large Orders Excluding Clearance Products #
Condition:
Products NOT IN LIST:
- Clearance Products
Quantity:
- Greater than or equal to 10
Attribute-Based Promotions #
Condition:
Attributes IN LIST:
- Color = Blue
Quantity:
- Greater than or equal to 2
Best Practices #
Use Cumulative Quantity for Most Promotions #
Cumulative quantity is easier for customers to understand and works well for most discount campaigns.
Use Per Matching Item for Product-Specific Requirements #
Enable per-item quantity evaluation when a single product must satisfy the requirement.
Verify Matching Products #
Always confirm which products are included in the matched quantity calculation.
Keep Conditions Simple #
Simple product conditions are easier to understand and troubleshoot.
Common Mistakes #
Assuming All Cart Items Are Counted #
Cart Item Conditions only count products that match the condition.
Non-matching products are ignored.
Confusing IN LIST and NOT IN LIST #
IN LIST counts matching products.
NOT IN LIST counts non-matching products.
Forgetting How Matched Quantity Works #
Matched Quantity only includes products that satisfy the condition.
Enabling Per Matching Item Unnecessarily #
Most promotions should use cumulative quantity calculations.
Per-item quantity evaluation is only needed for advanced scenarios.
