Commerce Mini Cart

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

Configuration

Add this table to your document to configure the block:

commerce-mini-cart
startShoppingUrl	/path/to/page (example)
cartUrl	/path/to/page (example)
checkoutUrl	/path/to/page (example)
enableUpdatingProduct	false
undoRemoveItem	false

Property descriptions

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

cartUrl: URL for cart page navigation.

checkoutUrl: URL for checkout navigation.

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

Basic mini cart (view and checkout only):

• Set enableUpdatingProduct to false
• Set undoRemoveItem to false
• Set checkoutUrl to /checkout
• Simple, streamlined experience

Enhanced mini cart (full product control):

• Set enableUpdatingProduct to true
• Set undoRemoveItem to true
• Set cartUrl to /cart
• Set startShoppingUrl 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
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.