B2B Capabilities
The Storefront SDK is in beta. Content in this section may be updated as the SDK evolves.
The SDK and UI components are built for B2B commerce, not just B2C. Several features reflect this across all three layers.
Portal modes
Components support two visibility modes via the portalMode prop:
| Mode | Behavior |
|---|---|
open | Full e-commerce. Prices visible. Add-to-cart enabled. |
semi-closed | Catalog-only. Prices and add-to-cart hidden for unauthenticated users. Price filtering and price-based sorting disabled. |
This is useful for B2B scenarios where pricing is customer-specific and should only be shown after login. Components that respect portal mode include ProductGrid (hides AddToCart), GridFilters (hides price filter) and GridToolbar (disables price sorting).
Contact-company model
The SDK supports the Propeller data model where Contacts belong to Companies, and Companies have associated price sheets, order lists and addresses. The UserService handles registration with before/after callbacks, enabling partners to:
- Assign a new contact to a company
- Link the contact to a price sheet
- Add the contact to an order list as part of the registration flow
See Understanding companies, contacts and customers for the underlying data model.
Clusters
Propeller's product model supports clusters (configurable product groups with variants). The SDK and components handle both standalone products and clusters, including cluster options (add-on product groups like insurance or accessories).
The ClusterCard component in the UI Components library handles cluster display, variant selection and option configuration.
See Understanding products and categories for how clusters work in the data model.
Customer-specific pricing
The SDK handles customer-specific pricing through Propeller's price sheet system. When a user is authenticated, the GraphQL proxy forwards their authorization header, and the API returns prices specific to their company's price sheet.
In semi-closed portal mode, unauthenticated users see the product catalog without prices. After login, customer-specific prices are displayed automatically.
See Customer-specific pricing for how price sheets and action codes work.
See also
- SDK Services — the typed services that power B2B features
- UI Components — components that support portal modes and clusters
- Understanding companies, contacts and customers — the B2B data model
- Customer-specific pricing — price sheets and action codes