In beta, with limited placesOpen to everyone in Q1 2027

↑↓ to move · Enter to open · Esc to close

Catalog and entities

What is a B2B price list?

A B2B price list is a table of prices that an online store assigns to a business customer or a group of customers and that replaces the public price for them: a blanket discount, a fixed price per product or variant and, often, prices by quantity tier. Only people who log in with an account it is assigned to can see it.

Written by
Reviewed by
Published 7 min read
Takeaway:

Key takeaways

  • A B2B price list swaps the public price for another one for a customer or a group: with a percentage, a fixed price per product or volume tiers.
  • In Shopify it is called a catalog: the fixed price beats the blanket adjustment, and if a customer has several catalogs, they see the lowest price.
  • In BigCommerce it is assigned by channel and customer group, and each combination of the two takes only one list at a time.
  • A search engine or an agent does not log in: the price it reads, and the one your structured data should carry, is the public one.

A B2B price list is not the PDF price sheet you email a distributor, and it is not a discount code anyone can type at checkout. It is a store setting that changes the price each business customer sees when they log in. It is the piece that makes B2B ecommerce possible in an online store, and it matters to you because of a consequence that gets forgotten during setup: your store now has two truths about price, the public one and each customer's, and only the public one reaches search engines and assistants.

How it works

Platforms call it different things, but the pieces are the same: who the list is assigned to, how the price is expressed and what happens with quantity.

Shopify BigCommerce
What it is called B2B catalog⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs Price list⁠[2]BigCommerce Help Center. Using Price Lists
Who it is assigned to B2B markets and, on the Shopify Plus plan, also a company location⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs Combinations of sales channel and customer group⁠[2]BigCommerce Help Center. Using Price Lists
How the price is set A blanket percentage adjustment and fixed prices per product or variant⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs A new price per product or variant, with its percentage discount, plus new sale and recommended retail (MSRP) prices⁠[2]BigCommerce Help Center. Using Price Lists
Volume pricing Up to 10 tiers per product⁠[3]Shopify Help Center. Setting up quantity rules and volume pricing in B2B Three kinds of tier: percentage, amount per unit or fixed price⁠[2]BigCommerce Help Center. Using Price Lists
If there is a conflict With several catalogs for the same location, the lowest price is shown⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs Each combination of channel and group takes only one list at a time⁠[2]BigCommerce Help Center. Using Price Lists

Shopify combines two ways of setting the price inside a catalog, and the fixed price beats the blanket adjustment. Its own example: candles at $10, a catalog with a 20% adjustment that brings them to $8, and one particular candle, costlier to make, with a fixed price of $9 that the adjustment does not touch.⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs On the Basic, Grow and Advanced plans you can have up to 3 active catalogs across all your B2B markets; Shopify Plus has no such limit, and each company location can have up to 25 catalogs assigned.⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs

Quantities are handled separately. A quantity rule forces purchases in multiples or sets a minimum and a maximum per order, always per variant. Volume pricing adds tiers: in Shopify's example, one unit at $20, $18.50 from 20 units, $17.75 from 50 and $16 from 100. One detail that changes the math: when a product has volume pricing, its price is fixed and the catalog's blanket adjustment stops applying.⁠[3]Shopify Help Center. Setting up quantity rules and volume pricing in B2B

BigCommerce starts from the catalog price, the one any visitor sees, and the list overwrites it product by product or variant by variant. It does not limit the number of lists, though it warns that keeping many can slow down the control panel, and it cautions that a price change can take up to 10 minutes to show in the store.⁠[2]BigCommerce Help Center. Using Price Lists

Which price search engines and agents see

A crawler does not log in with your customer's account. In a mixed Shopify store, only logged-in B2B customers see B2B prices,⁠[4]Shopify Help Center. Choosing a store type for your B2B business on Shopify and BigCommerce describes the typical case as one standard price for every visitor and another that only the chosen groups see.⁠[2]BigCommerce Help Center. Using Price Lists The price that a search engine or an agent can read on your product page is therefore the public one.

That settles what goes in your structured data. Google asks you not to mark up content that readers of the page cannot see,⁠[5]Google Search Central. General structured data guidelines so the offer price in the markup of the public page is the public price, not a customer's. The closest thing Google documents is member prices for a loyalty program: they are marked up separately and, if you provide them, you must also provide the regular price.⁠[6]Google Search Central. Merchant listing (Product, Offer) structured data

Schema.org does have vocabulary for describing prices by tier or by customer type: a unit price specification,⁠[7]Schema.org. UnitPriceSpecification the eligibleQuantity property, which says for which quantities a price applies,⁠[8]Schema.org. eligibleQuantity and eligibleCustomerType, which says for which type of customer an offer applies.⁠[9]Schema.org. eligibleCustomerType But Google's documentation on merchant listings mentions neither property,⁠[6]Google Search Central. Merchant listing (Product, Offer) structured data and eligibleCustomerType appears on between 1,000 and 10,000 domains, according to Schema.org itself.⁠[9]Schema.org. eligibleCustomerType

In a store

Fictional example. An invented coffee roaster sells 1 kg bags of coffee to individuals and to cafes from the same store. The public price is $20. Its "Hospitality" catalog has a 15% adjustment, a quantity rule (bags in multiples of 5) and two volume tiers. This is what each person sees on the same product page:

Who opens it Price per bag How they buy
A visitor without an account, and any crawler $20 By the unit
A cafe with the "Hospitality" catalog $17 In 5s
The same cafe, from 20 bags $16 (fixed price for the tier) In 5s
The same cafe, from 50 bags $15 (fixed price for the tier) In 5s

Both tiers have a fixed price, as in Shopify, so the 15% adjustment is not stacked on top of them.⁠[3]Shopify Help Center. Setting up quantity rules and volume pricing in B2B And on the public page, the one Google and agents read, the markup carries a single price: the one in the first row.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Roasted coffee beans, 1 kg bag",
  "offers": {
    "@type": "Offer",
    "price": 20.0,
    "priceCurrency": "USD",
    "availability": "https://schema.org/InStock"
  }
}
Warning:

What people often get wrong

Believing that the B2B customer's price reaches Google. No visitor without an account sees it,⁠[4]Shopify Help Center. Choosing a store type for your B2B business on Shopify and marking it up on the public page would be marking up something the reader cannot see.⁠[5]Google Search Central. General structured data guidelines The other half of the error is the opposite one: showing the cheapest tier's price on the public page as if it were the price. What gets marked up is what someone sees when they open the page without an account.

How to check it

  1. List which catalogs or price lists each customer has. In Shopify, if a location has several with the same product, it gets the lowest price.⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs
  2. Log in as a test B2B customer and review prices, tiers and quantities. Shopify recommends that the product page show the minimum quantity, so the customer knows how many units to add to the cart.⁠[3]Shopify Help Center. Setting up quantity rules and volume pricing in B2B
  3. Open the same product page in a private window and compare the price you see with the one in the page's markup: they have to match.⁠[5]Google Search Central. General structured data guidelines
  4. In BigCommerce, wait a few minutes before trusting a change: it can take up to 10 to show.⁠[2]BigCommerce Help Center. Using Price Lists
  5. Export the catalog to CSV to review every price in a spreadsheet. Shopify lets you export each catalog's prices, publishing and quantity rules, edit them and import them again.⁠[1]Shopify Help Center. Customizing B2B pricing using catalogs

With price tiers in sight, it is tempting to summarize them with AggregateOffer, the type that gives a low and a high price. But AggregateOffer is meant for one product with several offers, for example from different merchants,⁠[10]Schema.org. AggregateOffer not for the prices one merchant gives different customers. And Google is clear about merchant listings: they accept AggregateOffer in product snippets, but merchant listings require an Offer, because the merchant has to be the seller.⁠[6]Google Search Central. Merchant listing (Product, Offer) structured data Its entry explains what that offer carries.

To keep going, the catalog and entities reading path orders the rest of the terms.

Synonyms

English
B2B price list, wholesale price list
Español
tarifa mayorista, tarifa por cliente

Sources

  1. [1] Shopify Help Center. Customizing B2B pricing using catalogs. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
  2. [2] BigCommerce Help Center. Using Price Lists. Accessed . ↑ ↑ ↑ ↑ ↑ ↑ ↑ ↑
  3. [3] Shopify Help Center. Setting up quantity rules and volume pricing in B2B. Accessed . ↑ ↑ ↑ ↑
  4. [4] Shopify Help Center. Choosing a store type for your B2B business on Shopify. Accessed . ↑ ↑
  5. [5] Google Search Central. General structured data guidelines. Accessed . ↑ ↑ ↑
  6. [6] Google Search Central. Merchant listing (Product, Offer) structured data. Accessed . ↑ ↑ ↑
  7. [7] Schema.org. UnitPriceSpecification. Accessed . ↑
  8. [8] Schema.org. eligibleQuantity. Accessed . ↑
  9. [9] Schema.org. eligibleCustomerType. Accessed . ↑ ↑
  10. [10] Schema.org. AggregateOffer. Accessed . ↑

Change history

  • First English version.

This definition is published under CC BY 4.0. Reuse this definition freely, crediting Clione with a link to this page.

Make your catalog easy for bots to read

Clione fills every product page with what bots read best: the JSON-LD graph with its structured data, the meta description and the FAQs. You review and press Push; then we check your live store so it all stays published.