Crystallize logo

Tiered Pricing

Tiered pricing lets you set quantity breakpoints so larger orders get a lower unit price. Tiers are defined per price variant and per currency, and the effective unit price is resolved from the quantity at query time — in the cart, in your storefront, and in search.

Tiered Pricing

What is a price tier?

A tier is a quantity breakpoint on a product's price variant: a minimum quantity (the threshold) paired with a price. Tiers form a ladder — for example, 1+ at 100, 11+ at 89, 51+ at 79. Thresholds are whole numbers, the first threshold is always 1, and thresholds must increase. Tiers apply only when a quantity is known; without a quantity, the flat base price is used.

Tier types: volume vs graduated

Each tiered price variant uses one of two tier types:

  • Volume — the whole ordered quantity is charged at the price of the single tier it lands in.
  • Graduated — each quantity band is charged at its own rate, like tax brackets. The effective unit price is the blended average across the bands the quantity spans.

Per price variant and per currency

Tiers live on individual price variants. Because each price variant carries a single currency, tier ladders are effectively per currency: you set thresholds and prices independently for each price variant a product uses.

Enable tiered pricing on a price variant

Open a price variant and find the Tiered pricing section. Choose Enable tiered pricing to reveal the configuration controls. Use the Disable link to turn it off again.

Choose the tier structure

The Breakpoints dropdown controls how tiers are defined when pricing products:

  • Only freeform — each product defines its own quantity breakpoints from scratch. No presets are stored on the price variant.
  • Freeform + preset — you define named presets as starting points; when pricing a product, editors can adopt a preset or build custom tiers.
  • Only preset — every tiered price uses your preset breakpoints exactly. Editors can only fill in prices; thresholds and tier type are locked.

Define presets

When a preset structure is selected, add one or more presets. Each preset has:

  • A label — a unique name so editors can recognize it.
  • A tier type — Volume or Graduated.
  • Thresholds — the quantity breakpoints, shown in a From/To grid. The first breakpoint is fixed at 1, each From is editable, and the To column is derived automatically (the last tier is open-ended, shown as ∞). Use Add breakpoint to extend the ladder.

Breakpoints must be whole numbers of 1 or more, start at 1, and strictly increase.

Copy presets from another price variant

If other price variants already define presets, a Copy from another price variant section lists them. Click a preset to add it here, or use Copy all to bring them over at once. Presets already copied appear dimmed.

In the data grids

In the item data grid and the catalogue data grid, each price variant has a tier cell. When collapsed, it summarizes the tiers (for example, ranges with their prices) or shows "Price missing" when the structure is set but prices are not yet filled in. Empty, non-tiered cells stay muted.

Opening a tier cell reveals the same tiered pricing editor: a toggle to enable tiers, options to Use preset or Define custom tiers, the tier type control, and the tier table. You can copy a tier cell and paste it into another — the thresholds and tier type carry over; prices come along only when the target uses the same currency, otherwise they are left blank for you to fill in. Pasting into a preset-locked cell keeps the preset's thresholds.

;