Skip to content

Price lists & contract pricing

A price list is a contract expressed as data: what this buyer pays per unit, how the price improves with volume, and whether they must order by the case. One list can serve many companies, so a “Wholesale Tier 1” list written once covers every buyer on those terms.

Plans: B2B, B2B Growth, Enterprise

Requires app: B2B & Wholesale. Install B2B & Wholesale from Settings → Apps before these screens appear.

  • The Wholesale app installed, and a plan that includes b2b.price_lists.
  • The products you are pricing already exist, with the variants you intend to price. Price list rows attach to a variant, not to a product.
  1. Go to B2B → Price lists and choose Add price list.

  2. Fill in the list’s own settings:

    Field Required Notes
    Name Yes Up to 255 characters — “Wholesale Tier 1”, “Hotel group 2027”
    Currency No Leave empty to use the store currency
    Active — On by default; an inactive list changes nothing even when assigned
    Starts at No Empty means “already in force”
    Ends at No Empty means “no end”
  3. Create. The list appears with an item count of zero and its effective window shown as Always when both dates are empty.

Each row in a list prices one variant at one minimum quantity.

  1. On the list’s row, choose Manage items.

  2. Search for the product and pick it, then pick the variant. The variant’s current catalog price is used for the preview.

  3. Choose the price type:

    • Fixed price — an absolute unit price. It ignores the catalog price entirely.
    • Percent off — a discount calculated from the current catalog price, so it follows your retail pricing as that changes.
  4. Enter the value: the unit price, or the percentage.

  5. Set Min qty — the order quantity at which this tier starts. The default is 1.

  6. Optionally set Pack size to force order multiples.

  7. Add tier. The row is saved and the table re-sorts by variant, then by minimum quantity.

The screen shows a live preview as you type: the catalog price, the resulting unit price, and the full ladder for that variant in the form ≥1→€9.00, ≥12→€8.25, ≥48→€7.40. Read that line before saving — it is the cheapest way to catch a decimal in the wrong place.

Add several rows for the same variant with different minimum quantities to build a ladder. The tier with the highest minimum quantity the order reaches is the one that applies.

Min qty Price Applies to an order of
1 €9.00 1–11 units
12 €8.25 12–47 units
48 €7.40 48 units and up

Pack size forces order multiples — a case pack. Set it to 12 and the buyer can order 12, 24 or 36, but not 13. This is how you sell by the case without maintaining a separate “case of 12” product with its own stock.

A list does nothing until a company uses it.

  1. Open the company under B2B → Companies and go to its Pricing tab.

  2. Pick the price list, tick Set as primary, and Assign.

  3. To change which of several assigned lists governs checkout, use Make primary on its row.

The primary list governs checkout prices. Assigning a second list without making it primary changes nothing for the buyer — which is exactly how you stage next year’s contract before it starts.

Clone on a list’s row copies it, including every tier, as an inactive list. That is the right way to prepare a price increase: clone, edit the copy, set its start date, then activate it and make it primary when the date arrives.

Field Scope Effect
Currency List The currency the fixed prices are expressed in
Active List An inactive list is ignored even when assigned and primary
Starts at / Ends at List Outside the window the list does not apply
Price type Row fixed or percent_off
Price value Row The unit price, or the percentage
Min qty Row The quantity at which this tier starts
Pack size Row Forces order multiples

The buyer still pays catalog prices. Work through it in this order: the list is active, it is assigned to the company, it is marked primary, its effective window has started, and the company status is Active.

One variant is right and the others are not. Rows attach to variants, not products. A product with four variants needs four rows — or a percent-off row per variant.

Percent off gives a price nobody agreed to. Percent off follows the catalog price, so a retail price change moves the trade price with it. For a number that must not move, use a fixed price.

A buyer complains they cannot order 13. A pack size is set on that variant. Either that is the intent, or lower the pack size.

The ladder applies the wrong tier. The applicable tier is the highest minimum quantity the order reaches. A ladder with a gap — tiers at 1 and 48 but nothing at 12 — makes an order of 20 pay the single-unit price.

The clone has no effect. Clones are created inactive on purpose. Activate it and make it primary.

What is the difference between a fixed price and percent off? A fixed price is an absolute unit price that ignores your catalog price entirely. Percent off is calculated from the current catalog price, so it follows your retail pricing automatically. Use fixed for negotiated contracts and percent off for a standing trade discount.

How do I build a quantity break ladder? Add several rows for the same variant with different minimum quantities — for example 1, 12 and 48. The tier with the highest minimum quantity that the order reaches is the one that applies.

What does pack size do? It forces order multiples. A pack size of 12 means the buyer orders 12, 24 or 36, never 13. It is how you sell by the case without creating a separate case product.

What if a company has two price lists assigned? The one marked primary governs checkout prices. Assigning a second list without making it primary changes nothing at checkout, which is useful for staging a new contract before it takes effect.