For the complete documentation index, see llms.txt. This page is also available as Markdown.

Overview

The B2B Prices app embed is the storefront layer that surfaces your wholesale and volume discounts to logged-in B2B customers. It replaces the retail price on every product detail page and collection card with the customer's effective B2B price — automatically, on every page, without any theme code edits.

What it does

  • Overrides the price element on PDP, sticky add-to-cart bars, and product cards on collection / search / homepage / cart-recommendation surfaces

  • Auto-detects the theme (Dawn, Horizon, Craft, Refresh, plus a generic fallback for everything else)

  • Combines Wholesale + Volume rules per your Discount combination setting

  • Reacts live to variant changes and quantity changes — the volume tier shown updates the moment the customer hits the qty threshold

  • No flash of retail during the theme's async re-render — uses the cart button's disabled state as a precise theme lifecycle signal

Why an app embed (not a drag-into-section block)?

Before v1.1.0, merchants had to manually add a Wholesale Price block to each product template they wanted overrides on. That meant:

  • Theme code edits in the editor for every new product template

  • Two separate blocks for PDP vs. collection cards

  • Inconsistent placement across themes

  • Easy to forget when changing themes

With the app embed, all of that goes away. One toggle in Theme editor → App embeds → Orbit B2B Wholesale enables the whole storefront overlay. No drag, no per-section setup, no theme code touched.

What customers see

Strikethrough mode (default — recommended):

Replace mode:

The Save badge shows the actual total savings ((retail - final) / retail), so when Wholesale 30% + Volume 5% stack to give 33.5% off, the badge says Save 34% instead of one rule's nominal value.

Where prices show up

Surface
Override
Notes

Product detail page

Main price + sticky add-to-cart

Collection cards

Renders at qty=1

Search results

Same as collection cards

Featured product on homepage

Uses the card adapter

Cart drawer / cart page

Shopify cart computes discount via the function (no override needed; final price matches)

Eligibility

A customer counts as B2B-eligible if at least one wholesale or volume rule matches them. If no rule matches, the embed shows the theme's native retail price untouched.

The discount Function at checkout uses the same matching logic, so the price the customer sees on the PDP is the price they pay at checkout.

Next

Last updated

Was this helpful?