> For the complete documentation index, see [llms.txt](https://docs.foodcore.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.foodcore.io/wholesale-prices-growth-and-core/wholesale-prices.md).

# Wholesale price lists

{% hint style="info" %}
📦 Available on the **Growth** and **Core** plans.
{% endhint %}

If you sell to trade customers — shops, cafés, other kitchens — at different prices than your retail customers, wholesale price lists let you set that pricing once per customer rather than remembering it order by order.

## A price list is a pre-fill, not a pricing engine

This is the most important thing to understand about how price lists work: **a price list is a pre-fill, not a pricing engine.** When you pick a recipe on an order for a customer with a price list attached, the list fills in the **unit price** on that line for you. From that point on, the order keeps whatever price it was created with — it doesn't keep watching the list.

**Editing a list never rewrites an existing order, receipt, or total.** Change a price list next month and every order already placed stays exactly as it was; only new orders (or new lines) pick up the change.

## Three ways a line can price

A price list can price a recipe in one of three ways, in this precedence order:

1. **A pinned price** — a fixed figure you've set for that recipe on that list. A pinned price **never moves**, no matter what happens to the recipe's own selling price.
2. **A discount % off that recipe's current selling price.** Because this reads the recipe's selling price live, re-pricing the recipe re-prices this line automatically the next time it's used.
3. **The list's default discount** — a row on the list with **neither** a pinned price nor its own discount takes the list's overall default discount instead. This is the "10% off everything" case: set one default and every recipe not otherwise configured follows it.

Setting a pinned price on a row **clears that row's discount rule** — a row is either pinned or following a rule, never both, so there's no stale rule left to resurface later.

## Assigning a list to a customer

You can assign a price list to a customer from two places:

* The **customer editor** — pick the price list directly on the customer's record.
* **"Manage lists"** in the customer editor, which opens the same list management used on the Wholesale Prices page.
* The **Wholesale Prices** page itself, in the menu.

## Deleting a list

If you delete a price list, its customers **move back to normal (retail) pricing** rather than being left in a broken state. Nothing about their existing orders changes.

## Bulk pricing

Setting every row on a list one at a time is unnecessary for a straightforward discount. Use the **quick bulk buttons** — 5%, 10%, 15%, 20%, or 25% — to apply a discount to **all rows**, or just the rows you've selected, in one action.

## The margin column

The list management screen shows a **margin column** worked out from your ingredient costs. This column is marked **internal-only** — it's there to help you set sensible trade prices, not something you'd ever want a wholesale customer to see. See [The wholesaler sheet](https://docs.foodcore.io/wholesale-prices-growth-and-core/wholesaler-sheet.md) for the customer-facing export, which never includes cost or margin.

## What's next

* [The wholesaler sheet](https://docs.foodcore.io/wholesale-prices-growth-and-core/wholesaler-sheet.md)
* [Customer orders](https://docs.foodcore.io/customer-orders-growth-and-core/customer-orders.md)
* [Receipts and payments](https://docs.foodcore.io/customer-orders-growth-and-core/receipts-payments.md)
