Commerce blocks

This reference provides a complete list of all commerce blocks available for creating your storefront pages. Each block serves a specific purpose in the shopping experience.

Quick reference by experience

Commerce Block	Purpose	Common Usage
Shopping Experience
Product List Page	Displays product listings with filtering, sorting, and pagination	Category pages, search results pages
Product Details	Shows detailed product information with images, pricing, and options	Individual product pages (PDP)
Product Recommendations	Displays AI-powered product recommendations	Product pages, cart page, homepage
Commerce Cart	Shows shopping cart with items, pricing, and cart management	Cart page
Commerce Mini Cart	Displays cart summary in a dropdown or overlay	Site header, global navigation
Commerce Checkout	Provides complete checkout flow with shipping, payment, and order review	Checkout page
Customer Account
Commerce Login	Provides customer login form	Login page, account access page
Commerce Create Account	Allows new customers to register	Registration page, checkout (guest to account)
Commerce Confirm Account	Confirms account creation via email link	Email confirmation landing page
Commerce Forgot Password	Initiates password reset process	Password recovery page
Commerce Create Password	Sets new password after reset	Password reset landing page
Commerce Account Header	Displays customer name and account navigation	Account dashboard header
Commerce Account Sidebar	Shows account section navigation	Account pages sidebar
Commerce Addresses	Manages shipping and billing addresses	Account address book page
Commerce Customer Information	Displays and edits customer profile details	Account profile page
Commerce Customer Details	Shows customer information in order context	Order details page
Order Management
Commerce Orders List	Lists all customer orders with status and details	Order history page
Commerce Search Order	Allows guest order lookup by order number and email	Guest order tracking page
Commerce Order Header	Displays order number, date, and status	Order details page header
Commerce Order Status	Shows detailed order status and tracking information	Order details page
Commerce Order Product List	Lists products in the order with images and details	Order details page
Commerce Order Cost Summary	Shows order totals, taxes, shipping, and discounts	Order details page, order confirmation
Commerce Shipping Status	Displays shipment tracking and delivery information	Order details page, tracking page
Returns & Exchanges
Commerce Returns List	Lists all return requests with status	Account returns page
Commerce Create Return	Initiates return request with item selection and reasons	Return request page
Commerce Order Returns	Shows return details for a specific order	Order details page
Commerce Return Header	Displays return request number and status	Return details page
Gift Options
Commerce Gift Options	Allows adding gift messages and gift wrapping	Cart page, checkout page
Wishlist
Commerce Wishlist	Displays saved items for later purchase	Wishlist page, account section

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

Example:

Commerce Cart
Hide Heading	false
Max Items	10

Block naming conventions

All commerce blocks start with “Commerce” (except Product blocks)
Block names are case-sensitive
Use the exact spelling shown in this reference
Hyphens in the reference (e.g., “Mini Cart”) 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

Blocks by page type

Essential pages

Every storefront needs these core pages:

Homepage: Product Recommendations, Product List Page
Product Page: Product Details, Product Recommendations
Cart: Commerce Cart, Product Recommendations
Checkout: Commerce Checkout
Account Dashboard: Commerce Account Header, Commerce Account Sidebar

Optional pages

Enhance your storefront with these additional pages:

Wishlist: Commerce Wishlist
Order Tracking: Commerce Search Order, Commerce Order Status
Returns: Commerce Create Return, Commerce Returns List
Address Management: Commerce Addresses

Your first page - Step-by-step tutorial for creating a cart page
Page metadata - Configure page-level settings
Section metadata - Style your page sections
Personalization - Add personalized content to your storefront
Product Recommendations setup - Set up intelligent product recommendations

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