Skip to content

Search is only available in production builds. Try building and previewing the site to test it out locally.

Commerce blocks

Commerce Cart

Customers review items, update quantities, apply coupons, and proceed to checkout through this block. Place it on your cart page.

Commerce Cart block.

Commerce Cart block.

Configuration

Add this table to your document to configure the block:

commerce-cart
Hide Headingfalse
Max Items10 (example)
Hide Attributescolor, size (example)
Enable Item Quantity Updatefalse
Enable Item Removetrue
Enable Estimate Shippingfalse
Start Shopping Url/path/to/page (example)
Checkout Url/path/to/page (example)
Enable Updating Productfalse
Undo Remove Itemfalse

Property descriptions

Hide Heading: Controls whether the cart heading is hidden. Set to true to hide this feature. Default: false.

Max Items: Maximum number of items to display in cart. Leave empty to show all items.

Hide Attributes: Comma-separated list of product attributes to hide.

Enable Item Quantity Update: Enables quantity update controls for cart items. Set to true to enable this feature. Default: false.

Enable Item Remove: Enables remove item functionality. Set to true to enable this feature. Default: true.

Enable Estimate Shipping: Enables shipping estimation functionality. Set to true to enable this feature. Default: false.

Start Shopping Url: URL for “Start Shopping” button when cart is empty.

Checkout Url: URL for checkout button.

Enable Updating Product: Enables product editing via mini-PDP modal. Set to true to enable this feature. Default: false.

Undo Remove Item: Enables undo functionality when removing items. Allows customers to restore accidentally removed items. Default: false.

Common configurations

Quick checkout (streamlined cart):

  • Set enable-item-quantity-update to false
  • Set enable-estimate-shipping to false
  • Set checkout-url to /checkout
  • Minimizes steps before checkout

Full-featured cart (maximum customer control):

  • Set enable-item-quantity-update to true
  • Set enable-estimate-shipping to true
  • Set enable-updating-product to true
  • Set start-shopping-url to / 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
TitleCart
Robotsnoindex, nofollow
Cache Controlno-store

Section metadata

Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional:

section-metadata
Stylelight, highlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)

Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options.