Create a price list

Goal

Create a new price-list header, then add item prices.

Who it is for

Clerk with pricing.manage.

Preconditions

• Module pricing_promotions on; permission pricing.manage.
• Know the list Currency (ISO-3). Catalog items (and units if needed) should exist before you add lines.

Steps

1. Open Price lists → New price list (full-page form).
2. Enter required Code, Currency, and Name (translatable; tenant default locale required).
3. Optionally set Valid from / Valid to, Channel.
4. Check Default if this is the tenant fallback list when a quote does not name a list.
5. Optionally enable Publish to Commerce. To mark Commerce default, publishing must be on (exactly one commerce default among published lists).
6. Save. Then open Prices on the list (or from the list row) and Add price: pick Item, optional Unit, Min qty (default 1), Unit price ≥ 0.

Result

A saved price list exists. Quotes can resolve against it once lines cover the items you sell (and precedence/default/group wiring is in place).

Hard stops

• Commerce default without Publish to Commerce → Commerce default price list must be published to commerce.
• Duplicate line grain (same item/unit/min qty) → A price already exists on this list for the same item, variant, unit, and minimum quantity.
• Validation: code, name, currency required; unit price ≥ 0; min qty > 0.

Related

• Edit a price list
• Price list troubleshooting
• Price groups