Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
---
title: "Price Lists"
description: "Learn how to set alternative prices for a market, a sales channel or larger quantities in Spree Commerce."
---
A price list is a second set of prices sitting alongside your normal shop prices. It holds the products it covers, what each one costs in each currency, and the rules deciding who gets it. A shopper matching those rules pays the list's price, and everybody else pays your normal price.
Price lists suit prices that follow a situation rather than a customer: what a market pays, what a sales channel charges, or what a case of twenty-four costs compared with a single unit. The rules do the matching, so a shopper does not have to be identified or signed in for a list to reach them, unless the sales channel itself requires an account before anyone can browse.
A price list is not a catalog. A catalog is an agreement with named buyers, assigned to a company or a customer group, and it can hide products as well as price them. A price list points at a circumstance instead, reaches anybody in it, and only ever changes prices. Reach for a price list when the price depends on where the order comes from or how much is being bought, and for a catalog when it depends on who is buying. See [<u>Catalogs</u>](/user/catalogs/catalogs).
To manage price lists, navigate to **Products → Price Lists** in the admin dashboard.
<Note>A catalog keeps its prices on the catalog itself, so they will never appear under price lists. The two are managed separately even though both end up as prices a buyer pays.</Note>
## Reviewing Price Lists

The list shows one row per price list, with its description under its name.
| Column | What it means |
|---|---|
| **Name** | What the list is called, with its description underneath. |
| **Status** | **Draft** while it is being set up, **Active** once it applies, **Scheduled** when it is waiting for its start date, or **Inactive** once it has been switched off. |
| **Products** | How many products the list covers. |
| **Prices** | How many price slots the list holds across every currency, including slots still waiting for an amount. |
The **Status** filter narrows the list to any of the four states, and **Add filter** narrows it by start date, end date, or when a list was created or last updated.
<Note>A slot is counted for every variant of every product in every currency as soon as the product is added, so a new list with three products can show a large **Prices** figure before a single amount has been typed.</Note>
## How to Create a Price List
Click **New price list** to open a form with four sections.
- **Name** - What your team calls the list, such as the region or arrangement it covers. Shoppers never see it, and it is the only required field.
- **Description** - A note for your team on who the list is for.
- **Rules** - Who the list applies to. A list with no rules applies to every shopper.
- **Starts** and **Ends** - The dates it runs between. Leaving both empty means it applies from the moment it is activated, with no end date.
Click **Create**, and the list opens on its own page as a **Draft**, ready for its products.
## How to Choose Who a List Applies To

The **Rules** card holds the conditions a shopper has to meet. With more than one rule, **All rules must match** and **Any rule may match** decide how they combine. Each kind of rule can be used once per list, so one already in use is not offered again.
- **Market** - One or more of your markets. Leaving the box empty applies the rule in every market. A market rule reaches every shopper there, signed in or not. See [<u>Markets</u>](/user/settings/markets).
- **Channel** - Ties the list to a sales channel, so the same product can cost one thing in your online store and another somewhere else. See [<u>Sales Channels</u>](/user/settings/sales-channels).
- **Volume pricing** - A **Minimum quantity**, and a **Maximum quantity** where there is a ceiling. Leaving the maximum empty means no upper limit.
The pencil beside a rule edits it and the bin removes it, with the removal taking effect when the price list is saved.
<Note>Customer group and individual customer rules are not offered on price lists. To give a customer group or a company its own prices, assign them to a catalog instead.</Note>
## How to Add Products to a Price List

1. On the list's page, click **Add products**.
2. Search, tick each product you want, and click **Add**. Products already on the list are marked **Added**.
3. Click **Save** at the top of the page.
Until the page is saved, new products show as **New** with **After save** in the price column. Removing one works the same way: the cross at the end of a row strikes it through with an undo arrow beside it, and it is only removed on save.
Once saved, every variant of each product carries a price with a badge. **Entered** means an amount was typed on this list, and **Shop price** means the list holds no amount for it so the normal price is shown instead. Where quantity breaks exist, a marker beside the price says how many, and hovering it shows the price at each quantity.

## How to Enter Prices and Quantity Breaks

A price list has no currency of its own. A price is entered for each currency you sell in, and a shopper paying in that currency gets that price.
1. Click **Edit prices**. A full-screen grid opens with one row per variant.
2. Choose the currency at the top. The table on the list's page shows one currency at a time, so this grid is where the others are checked.
3. Click into a **Price** cell and type the amount, adding a **Compare-at price** where you show a crossed-out price.
4. For a lower price on larger orders, type a quantity in the empty row beneath a product's first price, then the price for that quantity. The first price always starts at **From qty** 1.
5. Click **Save prices**.
The grid stays open after saving, so you can switch currency and carry on. The header counts unsaved changes, and **Discard** throws them away.
### Quantity Breaks
A quantity break lowers the price of every unit in the cart once the quantity is reached, not just the units above it. Take a product priced at 35.00 with a break from 10 units at 30.00:
- A shopper with **9 in the cart** pays 35.00 each, so 315.00 in total.
- A shopper with **10 in the cart** pays 30.00 each, so 300.00 in total.
Adding the tenth unit makes the whole order cheaper than nine, which is the effect a case price is meant to have.
<Warning>
Two kinds of quantity break are refused, and the list will not save until they are fixed:
- **A quantity with no price against it.** Enter a price for the break, or clear the quantity to remove it.
- **A break costing more than the price below it.** A buyer taking more should never pay more per unit.
</Warning>
Prices on a list are separate from the prices on the product itself, so changing a product's own price leaves its price list amounts as they were. See [<u>Adding Products</u>](/user/products/adding-products).
## How to Activate a Price List
A new list starts as a **Draft** and reaches nobody. Click **Activate** to start enforcing it.
What happens next depends on the dates set on the list. With no start date, or one that has already passed, the status changes to **Active** and shoppers matching the rules see its prices straight away on the product page and in the cart. With a start date still in the future, the status changes to **Scheduled** instead, and the prices begin applying when that date arrives.
**Deactivate** switches it off again and keeps everything it holds, so activating it later brings its prices back.
Fill in every price you mean to charge before activating. A list carrying no rules, no products and no catalog cannot be activated at all, because it would price nothing.
<Note>To verify a price list has taken effect, open your storefront as a shopper the list should reach and look at one of its products. That single check tests the rules and the prices together.</Note>
## How to Update Prices from a Spreadsheet
**Import** and **Export** on the price list's page move its prices as a CSV file, which is how prices are changed in bulk without working through the grid row by row.
**Export** downloads every price on the list that has an amount. Empty slots are left out.
**Import** takes the file back:
1. Click **Import**, drop the file in or browse for it, and set the **Column separator** your file uses. **Download CSV template** gives an empty file in the right shape.
2. Click **Continue** and match each column to the field it holds. **SKU** and **Price** are required, and **Currency**, **Minimum quantity** and **Compare at Price** are optional.
3. Click **Start import**.
The result says how many rows were imported and how many failed.
An import changes only the prices its rows name, rather than replacing everything on the list. A price whose row is left out of the file keeps the amount it already had, so deleting a row from an exported file does not remove that price. Clearing the **Price** on a row is what removes it.
<Note>Because the minimum quantity is a column, quantity breaks travel as extra rows for the same SKU. The surest way to get a file the import accepts is to export the list first, change the amounts, and import the same file back.</Note>
## Further Reading
- [<u>Catalogs</u>](/user/catalogs/catalogs) - Agreed prices and ranges for a company or group
- [<u>Markets</u>](/user/settings/markets) - The regions and currencies a market rule picks from
- [<u>Sales Channels</u>](/user/settings/sales-channels) - The channels a channel rule picks from
- [<u>Adding Products</u>](/user/products/adding-products) - A product's own prices, which a list sits alongside
- [<u>Set Up Volume Pricing</u>](/user/how-to/volume-pricing) - Cheaper prices for bigger orders