Skip to content

Mini cart

Displays a mini cart icon with cart count and dropdown cart details.

  • Icon (icon) - Cart icon. Default: ti-shopping-cart.
  • Icon typography (typography) - Typography for cart icon. Only available when Icon is set.
  • Open on add to cart (AJAX) (checkbox) - Open mini cart when products are added via AJAX.

Enable Hide if empty to hide the entire Mini cart element on the frontend when the cart has no products. It remains visible in the Builder so you can edit it. This is separate from Cart count > Visibility, which only controls the count badge. The element updates after AJAX cart changes.

  • Visibility (select) - Show/hide cart count. Options: Hide (Always), Show (Always). Default: Hide if empty.
  • Background color (color) - Cart count background color. Only available when Visibility is not Hide (Always).
  • Border (border) - Cart count border settings. Only available when Visibility is not Hide (Always).
  • Typography (typography) - Cart count typography. Only available when Visibility is not Hide (Always).
  • Transform (transform) - Cart count transform. Only available when Visibility is not Hide (Always) and Off-Canvas is not Top or Bottom.
  • Height (number with units) - Cart count height. Only available when Visibility is not Hide (Always).
  • Width (number with units) - Cart count width. Only available when Visibility is not Hide (Always).
  • Top (number with units) - Cart count top position. Only available when Visibility is not Hide (Always).
  • Right (number with units) - Cart count right position. Only available when Visibility is not Hide (Always).
  • Bottom (number with units) - Cart count bottom position. Only available when Visibility is not Hide (Always).
  • Left (number with units) - Cart count left position. Only available when Visibility is not Hide (Always).
  • Position (select) - Subtotal position. Options: Right, Left.
  • Gap (number with units) - Gap between icon and subtotal. Only available when Position is set.
  • Typography (typography) - Subtotal typography. Only available when Position is set.

To show a custom empty state in the cart details instead:

  1. Create and publish a Section template containing the empty-cart message or layout.
  2. Select the Mini cart and open Content > Cart details.
  3. Leave Hide off and select the Section under Empty cart template.
  4. Enable Preview empty state to inspect the template in the Builder. This preview setting does not change the visitor’s cart.
  5. Save and test the frontend with an empty cart, then add and remove a product.

Leave Hide if empty off if visitors should be able to open this empty state. An unpublished, empty, or non-Section template cannot be used. Avoid placing the Mini cart inside the same Section template selected as its empty state.

Mini cart controls with Hide if empty off, an Empty cart template selected, and Preview empty state enabled.

The selected Section replaces the default empty-cart message:

An empty Mini cart displays a custom message and an Explore the collection button.

  • Hide (checkbox) - Hide cart details dropdown.
  • Don’t close on click outside mini cart (checkbox) - Prevent auto-close on outside clicks. Only available when Hide is not checked.
  • Off-Canvas (select) - Off-canvas position. Options: Top, Right, Bottom, Left. Only available when Hide is not checked.
  • Height (number with units) - Cart details height. Only available when Hide is not checked and Off-Canvas is not Top or Bottom.
  • Width (number with units) - Cart details width. Default: 400px. Only available when Hide is not checked and Off-Canvas is not Top or Bottom.
  • Image width (number with units) - Product image width. Default: 60px. Only available when Hide is not checked.
  • Padding (spacing) - Cart details padding. Only available when Hide is not checked.
  • Position (dimensions) - Cart details position. Only available when Hide is not checked and Off-Canvas is Disabled.
  • Transform (transform) - Cart details transform. Only available when Hide is not checked and Off-Canvas is not Top or Bottom.
  • Background (color) - Cart details background color. Only available when Hide is not checked.
  • Border (border) - Cart details border settings. Only available when Hide is not checked.
  • Box shadow (box-shadow) - Cart details box shadow. Only available when Hide is not checked.
  • Typography (Title) (typography) - Title typography. Only available when Hide is not checked.
  • Typography (Quantity) (typography) - Quantity typography. Only available when Hide is not checked.
  • Background color (color) - Button background color. Only available when Hide is not checked.
  • Border (border) - Button border settings. Only available when Hide is not checked.
  • Typography (typography) - Button typography. Only available when Hide is not checked.
  • Icon (icon) - Close icon. Only available when Hide is not checked.
  • Typography (typography) - Close typography. Only available when Hide is not checked and Icon is set. Excludes: font-family, font-weight, font-style, text-align, text-decoration, text-transform, line-height, letter-spacing.
  • Position (dimensions) - Close position. Only available when Hide is not checked and Icon is set.
  • Padding (spacing) - Close padding. Only available when Hide is not checked and Icon is set.
  • Background color (color) - Close background color. Only available when Hide is not checked and Icon is set.
  • Border (border) - Close border settings. Only available when Hide is not checked and Icon is set.