Quantity Pricing
Quantity Pricing automatically adjusts WooCommerce product prices when a customer buys a qualifying quantity. Choose Volume pricing to give every eligible unit the reached rate, or Graduated pricing to charge each quantity band separately. Count each product or variation on its own, or combine eligible products in one rule.
The feature includes global rules, product and variation overrides, customer-role restrictions, sale and coupon policies, scheduling, and two customizable Bricks elements. Cart prices, mini-cart output, checkout, Bulk Add to Cart estimates, and supported BU Product Addons previews use the pricing engine.
On this page
- Quick start
- Enable the feature
- Create a global rule
- Every rule field explained
- Volume versus graduated pricing
- Discount and price types
- Mixed-product grouping
- Simple-product settings
- Variable products and individual variations
- Rule priority and conflicts
- Guests and customer roles
- Sales, coupons, and scheduling
- Display the offer in Bricks
- Builder-only demo
- Cart, mini-cart, and checkout
- Bulk Add to Cart
- BU Product Addons
- Practical setups
- Supported scope and limitations
- Troubleshooting
- Before publishing
- Developer reference
- Related guides
Quick Start: A Beanie Offer
Use this example to check the complete workflow before configuring more advanced rules.
- Open Bricks > BricksUltimate > MISC, enable Quantity Pricing, and save changes.
- Open WooCommerce > Quantity Pricing and add a rule named Beanie quantity offer.
- Keep Active rule enabled. Leave All eligible products off and select the Beanie product.
- Leave Customer roles empty so the offer is available to everyone. If the Beanie already has a sale price, enable Include products already on sale.
- Choose Volume: one price for all units and Each product / variation separately.
- Add a break with Minimum quantity 10, Adjustment Fixed unit price, Value 15. Add another at 15 units with a fixed unit price of 10.
- Leave the dates empty and click Publish. If the product has its own pricing settings, set them to Inherit parent/global rules.
- On the storefront, add 10 Beanies to the cart. Their product component is priced at 15 per unit. Increase to 15 units to receive 10 per unit, then reduce below 10 to verify the normal eligible price returns.
- Optionally place the (BU) Quantity Pricing Table and (BU) Quantity Pricing Progress elements in the single-product template.
Values above are currency amounts in the store's price-entry context, not percentages. No coupon code is required. The standard catalog price is not rewritten; verify the adjusted cart unit price and line total.
Enable the Feature
Activate WooCommerce, Bricks, and BricksUltimate. In BricksUltimate > MISC, enable Quantity Pricing and save. This enables the WooCommerce rule menu, product-editor controls, variation controls, and both Bricks pricing elements.
No second Woo Elements switch is needed for these two elements. Reopen or reload Bricks after enabling the feature. Other elements, such as Bulk Add to Cart or Mini Cart Builder, still have their own activation settings.
Disabling Quantity Pricing stops its pricing engine and public element output. Saved rules and product settings are retained. Test the cart after a normal recalculation when changing pricing configuration; do not treat an already-open cached page as the latest pricing state.
Create or Edit a Global Rule
- Go to WooCommerce > Quantity Pricing, add a rule, and give it a recognizable internal name.
- Set its active state and priority. In Product scope, choose specific products/variations or All eligible products.
- Configure Customer eligibility: roles, coupon policy, and whether already-on-sale products are included.
- Under Quantity breaks, choose the pricing model and quantity grouping, then add the minimum quantities and adjustments.
- Review the live Offer summary. If needed, set the start and end dates in the Schedule section.
- Publish the rule, or click Update when editing an existing one. Test the offer outside the builder.
Active is not the same as Published. A draft with its active switch enabled does not apply. Invalid global rules are moved to Draft and a validation notice explains what needs correction. The list shows the active state, pricing model, grouping, targets, and priority.
Every Rule Field Explained
| Field | What to enter or expect |
|---|---|
| Rule name | An internal name to identify the offer in the admin. Use a descriptive name such as Trade beanies, not only Rule 1. |
| Active rule | Turns this rule on or off. A global rule must also be published. Inactive explicit product overrides do not fall through to an inherited rule. |
| Priority | Default 10. Lower numbers run first. Equal priorities use the earlier rule ID. Only the winning rule applies; quantity-pricing rules do not stack. |
| All eligible products | Targets all supported eligible products. The specific-product search is hidden while this is checked. It does not bypass roles, sale policy, overrides, or other eligibility checks. |
| Products and variations | Search by product name or SKU. Select at least one target unless All eligible products is enabled. Selecting a variable parent targets its eligible variations. |
| Customer roles | Leave empty for everyone. A restricted list matches the shopper's current WordPress roles. Include Guest explicitly when guests should qualify. |
| Coupon policy | Allow coupons on adjusted prices, or pause quantity pricing while a coupon is applied. Pausing does not remove or reject the coupon. |
| Include products already on sale | Off by default. Enable it to use the current sale price as the base. Otherwise sale products do not receive or qualify this rule. |
| Pricing model | Volume adjusts all eligible units to the reached rate. Graduated charges each band's units at that band's rate. |
| Quantity grouping | Count each product/variation separately, or combine items whose winning rule is this same rule. |
| Minimum quantity | The quantity at which a volume break is reached, or the starting unit number of a graduated band. Thresholds must be positive and unique. Graduated thresholds must be whole unit numbers. |
| Adjustment and Value | Select Percentage off, Fixed amount off per unit, or Fixed unit price. Enter a number, without a currency symbol or percent sign. Percentages must be between 0 and 100. |
| Add / Remove break | Add up to 30 breaks or remove a row using its trash button. At least one valid break is needed. Breaks are sorted when saved. |
| Offer summary | A readable description of the selected model, grouping, and bands. It is a setup aid, not a customer-specific cart simulator. |
| Start date / End date | Optional dates and times in the displayed WordPress site timezone. Leave empty for no time limit. An end date cannot precede the start date. |
Only the offer's targets and valid quantity breaks need configuration for a basic global rule. Roles and dates are optional; priority, pricing model, grouping, and coupon policy have defaults.
Volume Versus Graduated Pricing
Assume a normal eligible product price of 100, with these two breaks:
| Minimum quantity | Adjustment | Value |
|---|---|---|
| 3 | Percentage off | 10 |
| 6 | Fixed unit price | 70 |
Volume: the reached rate applies to every unit
At 3 units, each unit becomes 90. At 6 units, every unit becomes 70. Earlier units are repriced too. Use Volume for the familiar offer "Buy 6 or more at 70 each."
Graduated: each band is charged separately
Units 1-2 cost 100 each, units 3-5 cost 90 each, and units 6 onward cost 70 each. At 6 units, the total is (2 x 100) + (3 x 90) + (1 x 70) = 540. Reaching a new band does not reprice earlier units.
| Quantity | Volume product total | Graduated product total |
|---|---|---|
| 2 | 200 | 200 |
| 3 | 270 | 290 |
| 6 | 420 | 540 |
| 7 | 490 | 610 |
These examples exclude add-ons, coupons, shipping, and taxes. Graduated bands start at whole unit numbers. If a separate quantity extension allows fractional purchase quantities, fractions occupy proportional parts of a band; this feature does not itself enable fractional purchasing.
610 / 7. The displayed rounded rate may not multiply back exactly to the displayed total; WooCommerce calculates with the precise rate. The pricing table shows band rates, not this blended average.Discount and Price Types
| Adjustment | Example against a base price of 100 |
|---|---|
| Percentage off | Value 10 produces a rate of 90. Enter 10, not 0.10 or 10%. |
| Fixed amount off per unit | Value 15 produces a rate of 85. It subtracts 15 from each applicable unit, not once from the whole cart. |
| Fixed unit price | Value 70 sets the applicable rate to 70. It is a target price, not a 70-unit discount. |
In Volume, the reached rate applies to all eligible units. In Graduated, the rate applies only to that band's share. Rates cannot fall below zero or increase a product above its eligible base price. A fixed price of 70 will not raise a cheaper 50 product to 70.
Amounts use the store's product price-entry tax basis. WooCommerce calculates taxes afterward and formats displayed prices according to its settings. Changing a currency symbol alone does not provide currency conversion; test any external multi-currency pricing integration.
Mixed-Product Grouping
Each product / variation separately
This is the default. Two cart lines of the same simple product count together, including lines with different add-on configurations. Different simple products and different variations do not combine.
Combine eligible products in this rule
Use one global rule, select all products/variations that should share a count, and choose this grouping option. Two Beanies plus one Beanie with Logo now reach a 3-unit break. A variable parent's variations can also combine when they inherit the same grouped rule.
Only products whose winning rule is the same rule join the group. A separate higher-priority rule or an explicit override separates the item from that group. An opt-out, excluded sale product, gift, Order Bump, or separate add-on line cannot help other products reach a break.
Mixed volume pricing
At a 10% tier, a 100 product becomes 90 and a 200 product becomes 180. The shared quantity selects the tier; each product keeps its own base for the adjustment.
Mixed graduated pricing: proportional bands
Graduated groups share band proportions across every eligible line. They do not assign the cheapest products to one band or depend on which product was added first.
For six grouped units with the earlier example, each product receives 2/6 at its normal price, 3/6 at 10% off, and 1/6 at a fixed rate of 70:
| Product base | Blended unit calculation |
|---|---|
| 100 | ((2 x 100) + (3 x 90) + (1 x 70)) / 6 = 90 |
| 200 | ((2 x 200) + (3 x 180) + (1 x 70)) / 6 = 168.333333... |
Two units of the first product and four of the second produce a product total of approximately 853.33 before taxes and other adjustments. Reordering cart lines does not change the band allocation. Splitting identical configurations retains the same allocation, although normal per-line currency/tax rounding can affect displayed cents.
Simple-Product Settings
Edit a product and open Product data > Quantity Pricing. Choose one of these modes:
- Inherit parent/global rules: use the matching global rule for a simple product. This is the normal choice when managing offers centrally.
- Use specific quantity breaks: configure this product's own model, grouping, roles, sale/coupon policy, breaks, and schedule. Save the product.
- Disable quantity pricing: opt this product out, even if a global rule targets it.
A simple product's own override does not merge with a separate global rule just because their thresholds look the same. Mixed groups are scoped to a single winning rule. Use a global rule for a group of unrelated products.
Variable Products and Individual Variations
- Create the variable product and its purchasable variations in WooCommerce, including each variation's price and stock settings.
- For a shared global offer, select the variable parent or specific variations in the global rule. Leave the parent and relevant variations in Inherit mode.
- Choose separate counting for independent size/color quantities, or combined grouping to let eligible variations share the same rule's count.
- Alternatively, configure an override in the parent product's Quantity Pricing tab. In combined mode, its inheriting variations share that parent rule.
- To make one variation different, open Product data > Variations, expand it, and set its Quantity Pricing mode and breaks. Save variation changes and update the product as appropriate.
- On the storefront, select each variation and verify its offer and cart prices. A variable parent's pricing display waits for a selected variation.
Example: Small and Medium inherit the parent's combined offer. Large has an explicit override, and Limited Edition is disabled. Only Small and Medium count together. Large follows its own rule, and Limited Edition does not qualify the parent group.
A variation's explicit override takes precedence over the parent, including a parent opt-out. An inherited variation follows the parent's mode before considering global rules.
Rule Priority and Conflicts
- Check the individual variation's explicit mode, where applicable.
- Check the simple product or variable parent's explicit mode.
- If inheritance continues, check published global rules by ascending priority, then ascending rule ID.
- Use the first eligible matching global rule. Do not stack it with another quantity-pricing rule.
An explicit disabled mode stops inheritance. An explicit override that is inactive, out of schedule, or ineligible for the customer does not fall through to a global rule. Set the mode back to Inherit to use inherited pricing again.
A matching rule is chosen before checking whether its first quantity break has been reached. An offer that has not reached its first break does not fall through to another quantity rule. In mixed groups, only items assigned to the same winning rule contribute to that rule's count.
Guests and Customer Roles
An empty role selection means everyone. Once you select roles, only matching users qualify. Guest is a separate choice for shoppers who are not logged in.
For a customer-only offer, select Customer. For a wholesale role, select the role supplied by your role-management plugin. An administrator testing a Customer-only rule does not qualify merely because they own the site. Test using a real account with the intended role, and test Guest separately in a private browser window.
Sales, Coupons, and Scheduling
Products already on sale
Sale products are excluded by default. If a Beanie has regular price 20 and sale price 18, enable Include products already on sale to let the rule apply. A 10% quantity tier then uses 18 as the base and produces 16.20. A fixed unit price of 15 produces 15 when its tier is reached.
Coupon policy
Allow coupons lets WooCommerce apply otherwise valid coupons to the adjusted cart prices. Coupon restrictions still belong to WooCommerce. Pause when a coupon is applied restores normal eligible product pricing while the coupon is present. Removing it allows quantity pricing to resume.
Start and end dates
Start and end fields sit together in the Schedule section and use the site's WordPress timezone, shown beside the fields. Empty dates mean no time restriction. Eligibility is checked on quotes and cart calculations; no scheduled background job is required. An already-open page is not a live countdown, so refresh/recalculate when testing a date boundary.
Display the Offer in Bricks
Add (BU) Quantity Pricing Table for the tier list and (BU) Quantity Pricing Progress for the next-break message and optional bar. Use either or both. They are independently styleable and can be placed in product templates, product loops, popups, and other layouts with an explicit product/variation ID.
For a product page, use Cart + product quantity input. For a mini-cart or checkout display that should reflect purchased units only, use Cart quantity only. Otherwise a missing product input previews one additional unit, which can make a cart-only message appear one unit ahead.
These elements do not replace the normal WooCommerce product price element or add products by themselves. See the complete Table and Progress guides for every content, connection, and style control.
Builder-Only Demo Preview
When a real eligible rule is available, the builder uses it. For a variable product, it looks for the first eligible variation among the first 30 children. If there is no eligible product/rule, both elements show a sample only inside the authorized Bricks editor:
- Three sample tiers at 3+, 5+, and 10+ units, with store-formatted prices and savings.
- A highlighted reached tier and an 80% progress example.
- Your chosen headings, labels, colors, typography, and savings/bar visibility settings.
The demo renders without pricing AJAX requests. Clicking a sample tier does not change a quantity or cart. It is never a saved discount and is not shown to storefront visitors. A builder demo is not proof that a restricted customer or product actually qualifies; always test the frontend.
Cart, Mini-Cart, and Checkout
The engine changes eligible cart-item unit prices before WooCommerce calculates line totals, taxes, and coupons. Quantity pricing is not a coupon and not a negative fee. Do not expect a separate Quantity discount fee row.
Lowering quantities, removing another product from a mixed group, applying a pause-policy coupon, or losing eligibility recalculates every affected line. Session reloads restore the current adjusted prices. Applied rule details are stored as private order-line metadata through WooCommerce's order APIs.
- Cart Content: adjusted unit and line prices follow the final cart data.
- Mini Cart Builder: inside the Mini Cart Contents loop, use the (BU)Price element. Choose Selling price for a unit amount or Selling price x Quantity for a line subtotal. A catalog-price dynamic tag is not a cart-line price.
- Configured duplicates: two lines of one product with different add-ons retain their own final prices. Their quantities can still qualify together according to the rule.
- Classic and block checkout: WooCommerce's cart/Store API totals receive the adjusted prices. Do not recreate the calculation in text or JavaScript. Test the actual theme, gateway, and checkout extensions before launch.
Duplicate cart-fragment notifications are coalesced, and unchanged table rows are preserved instead of repeatedly rebuilt. A necessary update still refreshes the offer when the cart, variation, coupon, or customer context changes.
Cart Milestones gifts, Order Bump lines, known free-gift flags, and separate BU Product Addons/bundle add-on lines are excluded from qualification and repricing. Other cart fees or promotions can still affect final totals; test their stacking policy separately.
Bulk Add to Cart Integration
- Enable and place Bulk Add to Cart.
- Configure the quantity rule normally; no extra pricing switch is needed in the bulk element.
- Enable Live order estimate to show selected-product estimates.
- Select eligible products on multiple result pages and verify the group count, then add them and check the final cart.
Client mode uses eligible numeric tier profiles and decimal-safe calculations. Volume and graduated estimates update instantly as quantities change, without a pricing request for every edit. Server mode applies the same models using valid selected rows. Both include eligible cart quantities and retained selections across pages.
Mixed products can share the rule's count; variations remain separate order rows even when they share a group. Invalid, unavailable, or out-of-scope rows do not qualify a server-side tier. Required configuration is not bypassed: products needing add-ons may need the product-page Configure options flow.
BU Product Addons Integration
With the updated frontend files from both plugins, the add-ons form's Original product price and Grand total previews follow the volume price or graduated blended rate, including selected variations and eligible mixed-cart quantities. Neither pricing display element is required for this integration.
In this preview, Original product price represents the quantity-priced product component for the chosen quantity; it is not a permanent pre-discount catalog total. The add-on subtotal is then added to form the grand total.
| Component for six 100-base units | Volume example | Graduated example |
|---|---|---|
| Product component with the earlier rules | 420 | 540 |
| Add-on at 3 per unit | 18 | 18 |
| One-time setup charge of 6 | 6 | 6 |
| Configured grand total before other adjustments | 444 | 564 |
Percentage add-ons continue to use the original product base: a 10% add-on against 100 remains 10 per unit, not 7 or 9 because of a quantity tier. Per-unit and one-time charges are not discounted. Separate add-on lines do not help reach a product tier.
When editing a cart configuration, the replaced line's previous quantity is excluded from the preview count. Other qualifying products remain counted. Numeric tier profiles allow local preview updates; cart-context changes refresh the profile. This integration does not guarantee compatibility with every unrelated add-ons, currency, or pricing plugin.
Practical Setups
A wholesale price for each size separately
Create a global Volume rule targeting the variable parent. Choose separate product/variation counting and the wholesale role. Add breaks such as 6+ at 10% off and 12+ at 20% off. Six Small units qualify; three Small plus three Large do not. Keep the relevant parent/variation modes inherited.
Mix and match colors to reach one offer
Target the parent or the selected colors in one global rule. Choose combined grouping and Volume. Three units of one eligible color plus three of another reach a 6-unit break. A color with its own override does not join this group.
Charge only later units at the cheaper rate
Choose Graduated and separate counting. With 1-2 at normal price, 3-5 at 10% off, and 6 onward at 70, use the comparison table above to validate totals. Display the band table so shoppers do not assume every unit receives the final band's price.
A sale-product exception
If your normal group excludes sale items but one sale product should have an offer, create an explicit product override with Include products already on sale enabled. That item follows its override and no longer qualifies the original global group.
Supported Scope and Limitations
- Supported pricing targets are simple products and individual variations. A variable parent configures/targets children; it is not an independently purchasable cart unit.
- Groups belong to one rule. There is no shared group ID across different rules, category/tag target builder, cheapest-first allocation, or sequential cart-order allocation.
- Quantity pricing does not impose minimum purchase quantities, pack multiples, or quantity-input step values. Configure those separately and test their integration.
- It does not reserve stock, bypass required add-ons, replace checkout, or provide a countdown timer.
- There are no dedicated Quantity Pricing dynamic tags or Bricks interaction-trigger presets. The developer event below is a native JavaScript event, not a builder trigger added to the Interactions selector.
- Personalized pages must not share cached pricing markup or nonces between customers. Exclude cart/checkout and vary or bypass role-specific product-page caches.
- Test plugins that independently modify cart prices, currencies, tax display, bundles, or cart-line identity. Do not run two engines that unintentionally apply the same discount twice.
Troubleshooting
| Symptom | What to check |
|---|---|
| Rule does nothing | Confirm the MISC switch is saved, rule is active and published, correct product/variation is targeted, quantity reaches the break, and roles/dates/coupons allow it. |
| Beanie or another sale product is excluded | Enable Include products already on sale. This is off by default. Check both the parent and exact variation settings where applicable. |
| A global rule is ignored | Check product/variation opt-outs and explicit overrides. A different winning rule can also separate an item from a mixed group. |
| Mixed products do not combine | Choose Combine eligible products in this rule, and confirm all items use that same winning rule. Similar breaks in separate rules are not a shared group. |
| The catalog price did not change | Expected. Inspect the cart unit/line price or add the pricing table. The feature does not overwrite the stored catalog or sale price. |
| No discount fee appears | Expected. The engine changes cart unit prices rather than adding a fee or requiring a coupon. |
| Graduated unit price looks unusual | It is a blended rate. Compare the full band calculation with the line total, not a rounded displayed rate multiplied manually. |
| Builder shows an offer but frontend hides it | The editor may be showing the demo. Test a real eligible product/account; verify the selected variation and Hide when no eligible rule setting. |
| Progress is one unit ahead in a cart layout | Use Cart quantity only instead of the product-input preview source. |
| Wrong price on one mini-cart line | Use the cart-loop (BU)Price element, not a catalog-price tag. Update both plugins for add-ons integration and clear cached/minified assets. |
| Add-on preview ignores tiers | Deploy both updated plugin frontend files, use the normal WooCommerce product form, clear asset caches, and check JavaScript/network errors. Required add-ons still need valid selections. |
| Pricing request fails or looks stale | Refresh an expired page/nonce, check that WooCommerce AJAX is not blocked or cached, and inspect the selected input's quantity and matching product/variation. |
| Quantity rule save returns to Draft | Read the validation notice. Check duplicate/invalid thresholds, graduated fractional thresholds, percentage values over 100, missing targets, and reversed dates. |
Before Publishing
- Test one unit below, exactly at, and above every threshold, then lower the quantity again.
- Test Guest and each restricted role, including a non-qualifying role.
- Test simple products, each relevant variation, inheritance, explicit overrides, and opt-outs.
- For mixed groups, add/remove another eligible product and confirm every affected line updates.
- Check sale and coupon policies, schedule timezone, and dates.
- Test repeated cart updates, session reload, Cart Content, Mini Cart Builder, and the actual classic/block checkout used by the store.
- Test configured duplicates, per-unit/one-time add-ons, and required-field validation.
- Compare bulk selections across pages with final cart prices, keeping the estimate exclusions in mind.
- Verify the builder demo does not appear on the frontend when no real offer matches.
Developer Reference
bu_qp_cart_item_eligible receives the current eligibility boolean and cart item. Use it to exclude a custom reward line from both pricing and qualification:
add_filter( 'bu_qp_cart_item_eligible', function( $eligible, $item ) {
return $eligible && empty( $item['my_reward_flag'] );
}, 10, 2 );
bu_qp_base_price receives the numeric base price, product, and cart. Return a valid non-negative number when adapting another pricing context. Test quotes, actual cart totals, and any currency conversion together; a display-only filter is not a charging rule.
The Table element dispatches the bubbling native event bu_qp_updated after drawing a valid quote. Its detail includes quantity, active threshold, next tier, and formatted rows:
document.addEventListener('bu_qp_updated', function(event) {
const quote = event.detail;
console.log(quote.quantity, quote.active_min);
});
The element identifiers are bu-quantity-pricing-table and bu-quantity-pricing-progress. Frontend classes use bu-qp. The shared script initializer is buQuantityPricing. Client events and estimates are presentation data, not authority to charge a customer.