Wholesale pricing guide

How B2B Onboard price levels work: percentage, fixed or Shopify-managed prices, the CSV format, quantity breaks and rules, the routes by Shopify plan, and what stays after uninstalling.

What a price level is

A price level is the wholesale pricing an approved buyer sees: a percentage off retail or fixed prices from a file, plus optional quantity breaks and quantity rules. You create and edit levels under Settings → Wholesale pricing → Price levels. You never have to open Markets or Catalogs in Shopify admin yourself.

The app compiles each level into Shopify's own B2B pricing objects, so your theme shows the prices and Shopify checkout charges them:

  • Catalog — the level's catalog, named after the level with “(B2B Onboard)” after it.
  • Price list — attached to the catalog, in your store currency, with the level's percentage as its adjustment, plus any fixed prices and quantity breaks.
  • Publication — makes every product, and products you add later, available in the catalog.
  • B2B market (Basic, Grow and Advanced plans only) — the market the catalog belongs to. Approved company locations are added to it. On Shopify Plus there is no market: the catalog is assigned to the company location directly.

Nothing is added to your theme: no theme edits, no price rewriting, no cart hooks. Gift cards always keep their retail price on a level.

The level's page shows What gets written — a list of exactly these objects and rules — and the time and size of the last write. Beside the form, the panel turns into What happens on save while there are unsaved changes: it names each write the save will make and whether buyers see it at once or after a background write. Changing the percentage alone is a single price-list change (no product is rewritten), and rounding only applies to fixed prices (quantity-break variants and rows from a file). While prices are being written a banner shows how many variants are done so far; if a write fails or stops reporting progress, the banner offers Retry sync.

Percentage, fixed or leave as set

Each level sets its base price in one of three ways:

  • Percentage off retail — the price list takes a percentage off every product's retail price and follows retail when you change it. Choose a rounding: no rounding, round down to .95, or round to whole units. Currencies without decimals, such as JPY, always use whole units.
  • Fixed prices from a file — upload a CSV of SKUs and prices (see CSV format). Variants that are not in the file either get a percentage off retail or stay at retail; you choose which.
  • Leave prices as set in Shopify admin — the app only attaches buyers to the catalog and writes nothing to its prices. Use this when you already maintain the price list yourself.

Changing the percentage or the rounding updates the price list straight away. Products that have quantity breaks carry a fixed price (a Shopify rule), so after such a change the app writes those products' prices again; the banner on the level shows the progress.

CSV format

The file needs a header row. Two columns are required, and up to ten pairs of break columns are optional:

  • sku — the variant SKU, exactly as in Shopify.
  • price — the fixed price per unit, in your store currency, as a number with up to two decimals (for example 12.50).
  • break_qty_1 and break_price_1 up to break_qty_10 and break_price_10 — optional quantity breaks for that SKU. A break quantity is a whole number of 2 or more, and each break quantity must be higher than the one before.

Commas or semicolons both work as the separator. With semicolons, a decimal comma (12,50) is accepted too. Quoted fields are fine. If a SKU appears twice, the later row is used and the page warns you.

Example:

sku,price,break_qty_1,break_price_1,break_qty_2,break_price_2
CLOTH-40,30.00,12,28.50,48,27.00
SPRAY-1L,8.40,,,,

A file can have up to 20,000 rows and be up to 4 MB. When you choose a file, the page counts its rows and SKUs and lists any problems with their line numbers before anything is saved. Nothing is written until the file has no errors and you save.

Quantity breaks and rules

Quantity breaks give an extra discount when a buyer orders more of one variant. Add up to 10 tiers (Shopify's limit per product), each with a starting quantity and an extra percentage off the base price. The page shows an example price per tier for a retail price you choose, and a preview of the table a buyer sees.

Shopify only allows breaks on a fixed base price. On a percentage level the app therefore writes a fixed price, computed from the percentage, for each product the breaks apply to; those products no longer follow retail automatically, and the app writes them again when you change the percentage. On a level that leaves prices as set in Shopify admin there are no breaks, only quantity rules.

Quantity rules set a minimum per variant, a step (“sold in multiples of”) and a maximum per order. Shopify enforces them in the cart and at checkout and shows them on the quantity field.

Breaks and rules share one scope: all products, chosen collections, chosen products, or (on a fixed-price level) the SKUs in your file. Without breaks, the rules apply to all products. Products outside the scope keep the base price only.

The tier table and the quantity rules are rendered by your theme. Shopify's current theme generations, such as Dawn and Horizon, show them on the product page for B2B buyers.

Routes by plan and the three-level cap

  • Basic, Grow and Advanced: a level reaches buyers through its own B2B market. Shopify allows 3 active catalog assignments across B2B markets on these plans, and B2B markets you created yourself count towards the three. The Price levels page shows how many are in use. When all three are in use, you can still create a level: it is saved as Blocked by plan cap and nothing is created in Shopify until a slot is free, then Retry on the level creates it. The app never assigns a level the plan cannot show to the buyer.
  • Shopify Plus: each level is a catalog assigned directly to the buyer's company location, with no limit on the number of levels.

A company location in two B2B markets at once loses its quantity rules in Shopify, so keep each buyer on one level.

To delete a level, open it and choose Delete price level. This removes its catalog, price list and B2B market from Shopify. While company locations are still on the level, the app refuses and asks you to move them to another level first.

Which level a new buyer gets

Choose a Default price level under Settings → B2B Company. When you approve an application and the app creates the company, its location is placed on that level, so the buyer sees the level's prices and quantity rules from the first login. Only levels that are live in Shopify can be picked; the select appears once your first level is.

The default is where approval starts, not the only option: the price level you choose on the Approve page comes first, then the approval profile's level, then the default level. See How approval picks a level.

If the default level is deleted, the B2B Company page warns you and approved companies get no price level until you pick another one.

How approval picks a level

Every approval that creates or joins a B2B company decides one price level for the company's location. The first of these that applies wins:

  1. Your choice on the Approve page. Once at least one level is live in Shopify, the Buyer setup card shows a Price level list instead of the catalog or B2B market picker. The suggested level is marked: (suggested by profile), (suggested by Rule 2) or (shop default). The What will happen card names the level before you approve.
  2. The approval profile. Under Settings → B2B Company, each approval profile has a Price level setting: Shop default level, No price level, or a specific level. A form rule that picks a profile brings that profile's level with it.
  3. The default price level you chose for the store.

No wholesale pricing is always the last choice in the list. The company is created with its payment terms and tax settings, and the buyer sees retail prices. If your store assigned a B2B market or catalog before price levels existed, the list also offers it, marked (set before price levels), so you can keep doing what you did before.

If the level you or a profile picked can't be applied (for example, it was deleted or isn't live in Shopify yet), the buyer is still approved and you see a Price level not applied notice with the reason. The app never quietly puts the buyer on a different level instead.

When a level is applied, the buyer's approval email gets one extra sentence after your text: Your wholesale prices are active when you log in. It never names the level or shows prices, and your saved email template isn't changed. The application's timeline records Price level applied with the level's name and who chose it.

Shopify Flow: the Approve B2B Registration action has an optional Price level field. Enter the level's exact name (capitals and extra spaces don't matter). Leave it empty to use the profile or the default level. See the Flow guide.

Bulk approval and automatic approval use the profile, then the default level. Test runs show the level a real approval would apply.

Changing a buyer's level

The Companies list shows, for every company, its Price level (the level's name and pricing), its payment Terms and its Tax treatment: Exempt when the location collects no taxes at all, Reverse charge or Reseller exemption when it carries the rule B2B Onboard applied on approval, otherwise Not exempt. These are read from Shopify each time the page opens, so a change you make in Shopify admin shows here too. A company on no level shows Put on a level, which opens the company's page. When a company's locations disagree, the list says Locations on different levels or Mixed, and the company's page shows each location.

On the company's page, the Wholesale setup card at the top shows the price level, payment terms, how orders are placed (submitted directly or sent to review as draft orders), tax exemption and tax ID, and one line per location with its level. Payment terms and tax are edited in Shopify: Edit terms and tax in Shopify opens the company there.

To move a buyer, click Change level on the card, or Change / Put on a level next to a location. In the dialog:

  1. If the company has more than one location, pick the Location. Each location is moved on its own.
  2. Pick the new Price level. The location's level is marked (current). Levels that aren't live in Shopify yet, or were built for the other Shopify plan, are listed but can't be picked.
  3. Click Move to the level. The location leaves its old level and joins the new one.

No wholesale pricing takes the location off its level (the button reads Remove from level). The company keeps its payment terms and tax settings, and the buyer sees retail prices.

What the buyer sees: the new prices on their next page load, usually within a minute. Products already in an open cart stay in the cart and are repriced at checkout.

Earlier fixed prices: moving a buyer doesn't clean up fixed prices written earlier for the old level. They stay in Shopify until the nightly clean-up ships.

Every change is written to the audit log, and when the company came from an application, its timeline records Price level changed with the old and new level names. If the dialog can't make the change (for example, the level was deleted, isn't live in Shopify yet, or wholesale pricing is switched off for the store), it says why in one sentence and nothing is changed.

On Shopify's Company page: if you work in Shopify admin under Customers → Companies, you can see B2B Onboard there too. Open a company, use the page's app block picker (Add block) and pin B2B Onboard company. The card shows the company's Price level, payment terms, tax exemption, the application it came from, whether anything under Verification and agreements needs review, and its tax exemption certificates. Its links open the matching page in the app: Put on a level and Open in B2B Onboard open the company's page here, where Change level lives; View application opens the application; Manage opens the certificate on Action required. Each company location page has its own block (B2B Onboard company location) with that location's level, payment terms, how orders are placed and tax. The card only shows and links; every change is made in the app. A company that B2B Onboard didn't create says so, with a link to the app. On a customer's page (Customers → open the customer) pin B2B Onboard customer to see their application, their certificates and, when they belong to a company you manage, that company's level and anything that needs review.

Uninstalling

If you uninstall B2B Onboard, the catalogs, price lists, prices, quantity breaks and rules, payment terms and companies stay in Shopify exactly as they are. Your buyers keep their prices; nothing is rolled back. You can edit or delete these objects in Shopify admin afterwards.