Ezhance
← Documentation

Cart Item Conditions

Require specific products, categories, tags, or attributes to be present in the cart. Requires Ezhance Pro.

Cart Item Conditions evaluate specific products within the customer's cart, rather than the cart as a whole. They let you require that a customer has a minimum quantity of specific products, categories, tags, or attributes in their cart before a promotion applies. Requires Ezhance Pro.

How Matched Quantity Works

Cart Item Conditions evaluate only the products that match the configured rule. Non-matching products are ignored entirely.

Example: Rule = Categories IN LIST (Hoodies), Quantity ≥ 3. Cart has 3 Hoodies + 10 T-Shirts. Matched quantity = 3 (T-Shirts are ignored). The condition passes.

Available Condition Types

  • Products — Evaluate specific WooCommerce products by name
  • Categories — Evaluate products by their WooCommerce category
  • Attributes — Evaluate products by attribute values (e.g., Color = Blue)
  • Tags — Evaluate products by WooCommerce tag

IN LIST vs. NOT IN LIST

  • IN LIST — Only matching products are counted toward the quantity requirement
  • NOT IN LIST — Non-matching products are counted toward the quantity requirement

Example (NOT IN LIST): Products NOT IN LIST (Clearance Items), Quantity ≥ 5. The customer needs 5+ units of any product that is NOT clearance.

Quantity Evaluation Modes

  • Cumulative Quantity (default) — All matching products across the cart are combined into a single total. Use this for most promotions.
  • Per Matching Item — Each matching product type must individually satisfy the quantity requirement. Enable when you need each specific product to reach a threshold.

Common Use Cases

  • Buy 3 Hoodies rule — Categories IN LIST (Hoodies), Quantity ≥ 3
  • Buy 5 Featured Products — Tags IN LIST (Featured), Quantity ≥ 5
  • Buy 2 Blue Items — Attributes IN LIST (Color = Blue), Quantity ≥ 2
  • Order Excluding Clearance — Products NOT IN LIST (clearance items), Quantity ≥ 10

Common Mistakes

  • Assuming all cart items are counted — Only matching products contribute to the quantity total.
  • Confusing IN LIST and NOT IN LIST — Test both scenarios before activating.
  • Enabling Per-Item mode unnecessarily — Use this only when each specific product must individually meet the threshold.