Quantity Discount Rules

Quantity Discount Rules

Overview

Quantity discount rules let you offer volume-based pricing — the more a customer buys, the bigger the discount. Calculator AI supports two modes: 1D (Simple), where discounts depend only on quantity, and 2D (Advanced), where discounts depend on quantity plus a second numeric value like width or area. You configure quantity discount rules in Calculator Editor → Options & Pricing → Quantity Discount Rules. Click Configure to open the settings modal.

Steps

Setting up 1D (Simple) rules

  1. In the configuration modal, set Mode to Simple (1D).
  2. Choose an Aggregation mode (see Details below).
  3. Set Enabled to Enabled.
  4. Click Add new range to create your first tier.
  5. For each tier, enter a Min quantity, choose a Discount type, and enter a Value.
  6. Add as many tiers as needed. Each tier's min quantity must be higher than the previous one.
  7. Click Save.

Setting up 2D (Advanced) rules

  1. In the configuration modal, set Mode to Advanced (2D).
  2. Choose an Aggregation mode.
  3. Select an Axis source — a numeric option or computed variable that serves as the second dimension (e.g., width, area, weight).
  4. If the axis source is a Dimensions option, select which Dimension property to use (dim1, dim2, etc.).
  5. Click Add bracket to create your first axis bracket. Enter a Min and/or Max value for the axis range this bracket covers.
  6. Within each bracket, click Add new range to add quantity tiers. Each bracket has its own independent set of tiers.
  7. Add more brackets as needed for different axis ranges. Brackets must not overlap.
  8. Set Enabled to Enabled and click Save.

Details

Mode

Mode Description
Simple (1D) Tiers depend only on cart quantity. Use this for straightforward "buy more, save more" discounts.
Advanced (2D) Tiers depend on quantity plus a second numeric axis (an option or variable). Use this when the discount should vary based on both quantity and another measurement like size, weight, or area.

Aggregation

Aggregation controls how quantities from multiple cart lines are combined when determining which tier applies.

Aggregation Description
Per line No combining. Each cart line qualifies for tiers independently.
Per product Combines quantities only for the same product. Customers must reach tiers with the same product across multiple lines.
Per calculator Combines quantities across different products that use the same calculator. Tiers can be reached across multiple items.

Discount Types

Each tier (in both 1D and 2D mode) supports three discount types:

Discount Type Description
Percent off (%) Subtracts a percentage from the price. Value must be between 0 and 100.
Amount off ($) Subtracts a fixed dollar amount from the price.
Target unit price ($) Sets the unit price to a specific target amount.

1D Tier Settings

Each 1D tier has three fields:

Field Description
Min quantity The minimum quantity that activates this tier. Must be a whole number ≥ 1.
Discount type Percent off, Amount off, or Target unit price.
Value The discount amount, percentage, or target price depending on the type.

The highest matching tier is applied — if a customer orders 60 units and you have tiers at 10 and 50, the 50-unit tier is used.

2D Axis and Brackets

In 2D mode, you define an axis and one or more brackets:

  • Axis source — The numeric option or computed variable used as the second dimension. Only numeric option types (number, slider, length, area, volume, weight, dimensions) and computed variables are available. The Quantity option type is excluded since quantity is already the first dimension.
  • Dimension property — If the axis source is a Dimensions option, you must select which sub-dimension (dim1, dim2, etc.) to use.
  • Brackets — Each bracket defines a range on the axis using a Min and Max value. Leave Min blank for no lower bound, or Max blank for no upper bound. Brackets must not overlap, but they can touch (e.g., one bracket ending at 48 and the next starting at 48).
  • Tiers within brackets — Each bracket contains its own set of quantity tiers, configured the same way as 1D tiers. Different brackets can have different discount amounts for the same quantity range.

How Discounts Are Applied

  • Discounts are applied automatically at checkout as line item discounts — no discount codes are needed.
  • Quantity discounts apply to the product price only. Fixed fees are not discounted.
  • The discount is visible in the price summary if the Quantity Discount field is enabled in your Price Summary settings.
  • You can display a quantity tiers table on your product page by adding the CalcAI Quantity Tiers theme block or enabling it in the CalcAI Calculator block settings.

Examples

  • Simple volume discount (1D) — You sell custom stickers. Mode: Simple. Aggregation: Per line. Tiers: 25+ units → 5% off, 100+ units → 15% off, 500+ units → 25% off. A customer ordering 200 stickers receives 15% off automatically at checkout.
  • Size-dependent pricing (2D) — You sell custom metal signs in various widths. Mode: Advanced. Axis: Width (number input). Bracket 1: Width 0–24 inches with tiers 10+ → 10% off, 50+ → 20% off. Bracket 2: Width 24–48 inches with tiers 10+ → 5% off, 50+ → 15% off. Wider signs get smaller discounts because material costs are higher.
  • Target unit pricing (1D) — You sell custom packaging. Mode: Simple. Tiers use "Target unit price": 100+ units → $2.50 each, 500+ units → $1.75 each, 1000+ units → $1.25 each. Instead of a percentage discount, you set the exact price per unit at each quantity break.

    • Related Articles

    • Quantity option: inline price

      Overview For Quantity options using Dropdown or Radio list, you can enable Show price and discount inline. Shoppers then see the product line price for each fixed quantity (and for Custom, when a valid quantity is entered). Amounts use the same rules ...

    • Value Rules

      Overview Value rules let you automatically set an option's value when certain conditions are met. Instead of the customer filling in a field manually, the calculator can pre-fill it, override it, or lock it to a specific value. This is useful for ...

    • Visibility Rules

      Overview Visibility rules let you dynamically control whether an option is shown, hidden, required, or restricted based on what the customer has selected or entered elsewhere in the calculator. They make your calculator interactive and context-aware ...

    • Automatic Discounts

      Overview When you set up quantity discount rules in a calculator, Calculator AI applies those discounts automatically in the cart and at checkout. Customers who meet a quantity threshold see the savings on the relevant line item without entering a ...

    • Total Price Formula

      Overview The Unit price calculation / Total price calculation field (this section is titled Total Price Formula in the nav) is the main place you define how the line price is computed from options and base. You can also set minimum and maximum price ...