Mini cart
Displays a mini cart icon with cart count and dropdown cart details.
Settings
Section titled “Settings”- 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.
Hide an empty cart (since 2.5)
Section titled “Hide an empty cart (since 2.5)”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.
Cart count
Section titled “Cart count”- 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).
Cart subtotal
Section titled “Cart subtotal”- 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.
Custom empty cart template (since 2.5)
Section titled “Custom empty cart template (since 2.5)”To show a custom empty state in the cart details instead:
- Create and publish a Section template containing the empty-cart message or layout.
- Select the Mini cart and open Content > Cart details.
- Leave Hide off and select the Section under Empty cart template.
- Enable Preview empty state to inspect the template in the Builder. This preview setting does not change the visitor’s cart.
- 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.

The selected Section replaces the default empty-cart message:

Cart details
Section titled “Cart details”- 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.
Buttons
Section titled “Buttons”- 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.
Was this helpful?
A quick vote and short notes help us improve these docs faster.
Leave a note for us
Please do not include passwords, license keys, or personal data. We store submitted notes to improve the docs.
Thanks for sharing feedback. We're using it to improve these docs.