Commerce Cart
Customers review items, update quantities, apply coupons, and proceed to checkout through this block. Place it on your cart page.
Configuration
Add this table to your document to configure the block:
| commerce-cart | |
| hideHeading | false |
| maxItems | 10 (example) |
| hideAttributes | color, size (example) |
| enableItemQuantityUpdate | false |
| enableItemRemove | true |
| enableEstimateShipping | false |
| startShoppingUrl | /path/to/page (example) |
| checkoutUrl | /path/to/page (example) |
| enableUpdatingProduct | false |
| undoRemoveItem | false |
Property descriptions
hideHeading: Controls whether the cart heading is hidden. Set to true to hide this feature. Default: false.
maxItems: Maximum number of items to display in cart. Leave empty to show all items.
hideAttributes: Comma-separated list of product attributes to hide.
enableItemQuantityUpdate: Enables quantity update controls for cart items. Set to true to enable this feature. Default: false.
enableItemRemove: Enables remove item functionality. Set to true to enable this feature. Default: true.
enableEstimateShipping: Enables shipping estimation functionality. Set to true to enable this feature. Default: false.
startShoppingUrl: URL for “Start Shopping” button when cart is empty.
checkoutUrl: URL for checkout button.
enableUpdatingProduct: Enables product editing via mini-PDP modal. Set to true to enable this feature. Default: false.
undoRemoveItem: Enables undo functionality when removing items. Allows customers to restore accidentally removed items. Default: false.
Common configurations
Quick checkout (streamlined cart):
- Set
enableItemQuantityUpdatetofalse - Set
enableEstimateShippingtofalse - Set
checkoutUrlto/checkout - Minimizes steps before checkout
Full-featured cart (maximum customer control):
- Set
enableItemQuantityUpdatetotrue - Set
enableEstimateShippingtotrue - Set
enableUpdatingProducttotrue - Set
startShoppingUrlto/for empty cart - Gives customers flexibility to modify before checkout
Important notes
- Uses default configuration values if custom settings are missing or invalid.
- All URL paths must point to valid pages on your site for navigation to work correctly.
Page metadata
Configure page-level metadata in the document authoring table below:
| metadata | |
| Title | Cart |
| Robots | noindex, nofollow |
| Cache Control | no-store |
Section metadata
Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional:
| section-metadata | |
| Style | light, highlight (optional) |
| Padding | medium (optional) |
| Margin | small (optional) |
| Column Width | 30% (optional) |
| Gap | small (optional) |
Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options.