B2B Commerce blocks
B2B Commerce blocks
This reference provides a complete list of all B2B commerce blocks available for creating your storefront pages. Each block serves a specific purpose in the B2B shopping experience.
B2B commerce blocks
These blocks power B2B storefronts. They provide company management, purchase order workflows, quote negotiation, and requisition list features for business-to-business commerce.
| Commerce Block | Purpose | Common Usage |
|---|---|---|
| Company Management | ||
| Create Company | Customers register new companies to access B2B purchasing features | Company registration pages |
| Accept Company Invitation | Invited users join companies | Invitation acceptance pages |
| Company Profile | Company administrators update business details and contact information | Company profile pages |
| Company Structure | Company administrators organize teams and departments | Company structure pages |
| Company Users | Company administrators add team members and manage user access | Company user management pages |
| Company Roles and Permissions | Company administrators control who can approve orders and access features | Roles and permissions pages |
| Company Credit | Company buyers view credit balances and transaction history | Company credit pages |
| Customer Company | Company users view their company affiliation and job title | Account information pages |
| Purchase Orders | ||
| Purchase Order Status | Users view order status and take actions like approve, reject, or cancel | Purchase order detail pages |
| Purchase Orders Requiring Approval | Approvers see orders awaiting their review and prioritize approval processing | Orders for approval pages |
| Purchase Order History Log | Users view audit trails showing who approved orders and when actions occurred | Purchase order detail pages |
| Purchase Order Header | Users navigate purchase order details with contextual page headers | Top of purchase order pages |
| Customer Purchase Orders | Buyers track their own purchase orders and monitor approval status | My purchase orders pages |
| Company Purchase Orders | Managers monitor all company spending and track pending approvals | Company purchase orders pages |
| Purchase Order Comments List | Team members view order discussions and approval reasons | Purchase order detail pages |
| Purchase Order Comment Form | Team members communicate about orders and document decisions | Purchase order detail pages |
| Purchase Order Checkout Success | Buyers receive purchase order confirmation and order numbers | Purchase order confirmation pages |
| Purchase Order Approval Rules List | Administrators view all approval rules and which orders they affect | Approval rules pages |
| Purchase Order Approval Rule Form | Administrators create spending limits and set approval hierarchies | Create approval rule pages |
| Purchase Order Approval Rule Details | Administrators review rule conditions and approval requirements | Approval rule detail pages |
| Purchase Order Approval Flow | Users view workflow status and who approved or rejected orders | Purchase order detail pages |
| Quotes | ||
| Negotiable Quote | Buyers request custom pricing and negotiate terms with your sales team | Quote pages |
| Negotiable Quote Template | Buyers create reusable quote templates for recurring orders | Quote template pages |
| Quote Checkout | Buyers complete negotiated quote purchases with approved pricing | Quote checkout pages |
| Requisition Lists | ||
| Requisition Lists | Buyers create shopping lists for recurring orders | Requisition list pages |
| Requisition List View | Buyers review and add items to cart from saved requisition lists | Requisition list detail pages |
Using commerce blocks
Adding a block to your page
- In the Document Authoring tool, create a table with the block name.
- Add configuration options as key-value pairs in the table.
- The block will automatically render when the page is published.
Examples:
Simple block with configuration:
| commerce-company-credit | |
| Show History | true |
Multiple blocks on one page (purchase order detail):
| commerce-b2b-po-header | |
| commerce-b2b-po-status | |
| commerce-b2b-po-approval-flow | |
| commerce-b2b-po-comments-list | |
| commerce-b2b-po-comment-form | |
Block naming conventions
- All B2B commerce blocks start with “Commerce”
- Block names are case-sensitive
- Use the exact spelling shown in this reference
- Hyphens in the reference should be spaces in tables
Configuration options
Each block has its own set of configuration options. For detailed configuration information:
- View the individual block documentation for specific configuration options.
- Most blocks have optional configuration (they work with defaults).
- Configuration keys are case-sensitive.
Common page patterns
These patterns show how blocks work together to create complete B2B pages:
Purchase order detail page: Combine Purchase Order Header, Purchase Order Status, Purchase Order Approval Flow, Purchase Order Comments List, and Purchase Order Comment Form to create a complete purchase order detail page.
Company administration dashboard: Use Company Profile, Company Structure, Company Users, and Company Roles and Permissions blocks on separate sections or pages to provide complete company management functionality.
Quote workflow: Use Negotiable Quote Template to create reusable templates, Negotiable Quote to manage active quotes, and Quote Checkout to complete purchases from approved quotes.
Blocks by page type
For B2B storefronts, add these specialized pages:
Company management pages
- Company registration: Use the Create Company block.
- Company profile: Use the Company Profile block.
- Company administration: Combine Company Structure, Company Users, and Company Roles and Permissions blocks on separate sections or pages.
- Company credit: Use the Company Credit block.
Purchase order pages
- Purchase order list: Use Customer Purchase Orders (for buyers) or Company Purchase Orders (for managers).
- Purchase order detail: Combine Purchase Order Header, Purchase Order Status, Purchase Order Approval Flow, Purchase Order Comments List, and Purchase Order Comment Form blocks.
- Orders for approval: Use Purchase Orders Requiring Approval block.
- Approval rules management: Use Purchase Order Approval Rules List, Purchase Order Approval Rule Form, and Purchase Order Approval Rule Details blocks.
Quote pages
- Quote management: Use Negotiable Quote block.
- Quote templates: Use Negotiable Quote Template block.
- Quote checkout: Use Quote Checkout block.
Requisition list pages
- Requisition list management: Use Requisition Lists block.
- Requisition list detail: Use Requisition List View block.
Related resources
- Your first page - Step-by-step tutorial for creating a page.
- Page metadata - Configure page-level settings.
- Section metadata - Style your page sections.
Need help?
- Missing a block? All available blocks are listed in the table above.
- Configuration not working? Review the individual block documentation for exact option names.
- Block not appearing? Verify the block name is spelled exactly as shown in this reference.