Skip to content

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

Commerce blocks

Commerce Mini Cart

Customers view cart contents and proceed to checkout through this dropdown. Place it in your site header for quick access.

Commerce Mini Cart block.

Commerce Mini Cart block.

Configuration

Add this table to your document to configure the block:

commerce-mini-cart
Start Shopping Url/path/to/page (example)
Cart Url/path/to/page (example)
Checkout Url/path/to/page (example)
Enable Updating Productfalse
Undo Remove Itemfalse

Property descriptions

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

Cart Url: URL for cart page navigation.

Checkout Url: URL for checkout navigation.

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

Basic mini cart (view and checkout only):

  • Set enable-updating-product to false
  • Set undo-remove-item to false
  • Set checkout-url to /checkout
  • Simple, streamlined experience

Enhanced mini cart (full product control):

  • Set enable-updating-product to true
  • Set undo-remove-item to true
  • Set cart-url to /cart
  • Set start-shopping-url to / for empty cart
  • Customers can edit products and undo removals

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.

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.