Quantity discounts & pricing for woocommerce – documentation

Part 1: Product Quantity Rules

Product Quantity Rules are the heart of your tiered pricing and bulk discount strategy. These rules apply discounts directly to individual products based on the quantity a customer adds to their cart.

Location: WooCommerce > Quantity Discounts > Product Quantity Rules tab

Creating a Product Quantity Rule

  1. Click the “Add New Quantity Rule” button.
  2. Give your rule a descriptive Title (e.g., “T-Shirt Bulk Discount” or “Wholesale Coffee Bean Pricing”). This is for your reference only.

Configuring the Rule

The configuration is split into two main sections:

This is where you define your pricing tiers. You can add as many tiers as you need.

  • Start Qty: The minimum quantity for this discount tier to apply.
  • End Qty: The maximum quantity for this tier. For the highest tier (e.g., “50 or more”), you can enter a very large number like 999999.
  • Discount Type:
    • Fixed Discount: Reduces the product’s regular price by a fixed amount (e.g., “$5 off”).
    • Percentage Discount: Reduces the product’s regular price by a percentage (e.g., “10% off”).
    • Fixed Price: Overrides the product’s price and sets it to this exact value (e.g., “Price becomes $15”). This is also known as “Price per Quantity”.
  • Amount: The numeric value for the discount (e.g., 5, 10, or 15).
  • + Add Range Button: Click this to add another pricing tier.
  • – Button: Removes the corresponding tier.

Example: To set up “Buy 5-9 for 10% off, and 10+ for 20% off”:

  • Row 1: Start: 5, End: 9, Type: Percentage Discount, Amount: 10
  • Row 2: Start: 10, End: 999999, Type: Percentage Discount, Amount: 20

This section controls where and how the rule is applied.

  • Rule Priority: A number used to decide which rule applies if a product matches multiple rules. A lower number means higher priority (e.g., a rule with priority 1 will be chosen over a rule with priority 10). This is crucial for managing overlapping category and product-specific rules.
  • Calculation Mode:
    • Count quantity of each product individually (Default): This is for standard tiered pricing. The quantity of each specific product in the cart is checked against the ranges.
    • Sum quantities of all selected products/categories (Mix & Match): This powerful mode is for “bundle” deals. The plugin will sum the total quantity of all items in the cart that match this rule’s “Apply On” condition. For example, if the rule applies to 3 different T-shirts, the system will count the total number of those T-shirts in the cart to determine the discount tier.
  • Apply On:
    • All Products: The rule applies to every product in your store.
    • Specific Products: A searchable box appears, allowing you to select the exact simple products or product variations this rule applies to.
    • Product Categories: A searchable box appears, allowing you to select entire product categories. The rule will apply to any product within those categories.
  • Applicable User Roles: Leave blank to apply the rule to all customers. Select one or more user roles (e.g., “Wholesale Customer,” “Member”) to restrict this rule to only those logged-in users.

Part 2: Cart Discount Rules

Cart Discount Rules apply a single discount to the entire shopping cart if a set of conditions is met. This is perfect for site-wide sales and targeted promotions. The discount appears as a separate line item (a negative fee) in the cart totals.

Location: WooCommerce > Quantity Discounts > Cart Discount Rules tab

Creating a Cart Discount Rule

  1. Click the “Add New Cart Rule” button.
  2. The Title you enter here is important, as it will be visible to the customer in the cart (e.g., “VIP Summer Discount” or “Bulk Order Bonus”).

Configuring the Rule

  • Discount Type:
    • Fixed Cart Discount: Applies a fixed amount discount to the entire cart (e.g., “$10 off”).
    • Percentage Discount: Applies a discount based on a percentage of the cart subtotal.
  • Discount Amount: The numeric value of the discount.
  • Priority: Similar to Product Rules, a lower number runs first.
  • Execution: If “Stop processing other cart rules…” is checked, and this rule is successfully applied, no other lower-priority Cart Rules will be checked. This is useful for preventing “discount stacking”.

This is the most powerful feature of Cart Rules. The logic is: the discount applies if ALL conditions in ANY group are met.

  • + Add “OR” Condition Group: Click this to create a new, separate set of conditions.
  • + Add “AND” Condition: Click this within a group to add another condition that must also be met for that group to be valid.

Available Conditions:

  • Cart Subtotal: Checks if the cart subtotal is greater than, less than, or equal to a specific amount.
  • Cart Total Quantity: Checks the total number of items in the cart.
  • Product(s) in Cart: The group is valid only if one of the specified products is in the cart.
  • Category in Cart: The group is valid only if a product from one of the specified categories is in the cart.
  • Coupon Code Applied: The group is valid only if one of the specified coupon codes has been applied to the cart.
  • User Role: The group is valid only if the logged-in user has one of the specified roles.

Example: “15% off for VIPs on orders over $200, OR for anyone who buys the ‘Annual Pass’ product.”

  • Group 1:
    • Condition 1: Cart Subtotal >= 200
    • Condition 2: User Role is VIP
  • Click + Add “OR” Condition Group.
  • Group 2:
    • Condition 1: Product(s) in Cart is Annual Pass

Part 3: Global Settings

These settings control the plugin’s global behavior and appearance. For a detailed guide on the initial setup, please refer to the “Initial Setup” section of this manual.

Location: WooCommerce > Quantity Discounts > Settings tab

  • Pricing Table & Display Settings: Control the on-page pricing table’s position and whether to show a “Starting From” price on shop pages.
  • Table Column Settings: Customize the text and visibility of the Quantity, Discount, and Price columns.
  • Table Styling: Set custom colors for the pricing table to match your brand.
  • Discount Logic:
    • Coupon Interaction: Define how your plugin’s discounts should interact with standard WooCommerce coupons. You can allow both, or have one disable the other.
    • Discount Promotions: Enable this to show a “View Discounts” button on shop pages, which opens a popup advertising your available Cart Rules to customers. This is a great way to boost engagement and encourage larger purchases.