Skip to main content
Documentation/Elements & Controls Reference/Elements/WooCommerce/Mini Cart

Mini Cart

Mini Cart displays a compact cart link and an expandable cart interface. Use it in a header or other persistent store navigation. WooCommerce must be installed and active.

Add and configure Mini Cart

  1. Click Add, choose Mini Cart, and place it in the container.
  2. Configure Content > Content > Link and Cart.
  3. Set After Title Bar and After Footer if additional content is needed.
  4. Style Design > Link, Cart, Spacing, and Advanced.
  5. Save your changes.
Mini Cart controls in the Breakdance editor
Mini Cart controls in the Breakdance editor

This element has no children; use its own controls.

To use an off-canvas cart, open the Design tab and set Cart > Style > Sidebar. Choose Sidebar Position > Left / Right, then configure the panel's size, background, spacing, and close button.

From the Content tab, open Content > Cart:

  • Open Cart On Add opens the panel after a supported add-to-cart event.
  • Hide Quantity Input hides the quantity fields inside the cart. This is separate from the cart link's item count.

Style quantity fields and plus/minus buttons through WooCommerce Global Settings.

Full Breakdance editor showing Mini Cart in Sidebar style with its position setting
Full Breakdance editor showing Mini Cart in Sidebar style with its position setting

Controls

Responsive varies by breakpoint; Hover has a hover value; Shared applies across both. Linked controls have their own reference. In conditions, = means “is” and ≠ means “is not.”

Content > Content

Setting Purpose and options Behavior
Link > Hide Count On/off. Shared
Link > Hide Count When Empty On/off. When: Hide Count is unset. Shared
Link > Hide Subtotal On/off. Shared
Link > Hide Subtotal When Empty On/off. When: Hide Subtotal is unset. Shared
Link > Attributes Add attribute name and value pairs. Shared
Link > Attributes > Name Attribute name. Shared
Link > Attributes > Value Attribute value. Shared
Cart > Top Bar Enable, Disable. Shared
Cart > Primary Button Cart, Checkout. Shared
Cart > Continue Shopping Link Disabled, Homepage, Shop Page, Custom. Shared
Cart > URL Destination URL. When: Continue Shopping Link = Custom. Shared
Cart > Open Cart On Add On/off. Shared
Cart > Hide Quantity Input On/off. Shared
After Title Bar Existing Global Block. Shared
After Footer Existing Global Block. Shared
Setting Purpose and options Behavior
Container > Padding spacing controls. See linked controls
Container > Borders > Radius Set the corner radius. Responsive
Container > Borders > Styling Set border width, style, and color. Responsive
Container > Borders Hover Color or supported fill. Shared
Container > Background Color or supported fill. Hover
Container > Shadow Shadow offset, blur, spread, color. Hover
Icon > Color Color or supported fill. Hover
Icon > Size Size and unit. Shared
Icon > Icon Icon. Shared
Subtotal > Typography typography controls. See linked controls
Subtotal > Space After Space after and unit. Shared
Quantity > Overlap On/off. Shared
Quantity > Space Before Space before and unit. When: Overlap is unset. Shared
Quantity > Top Nudge Top nudge and unit. Shared
Quantity > Right Nudge Right nudge and unit. Shared
Quantity > Background Color or supported fill. Hover
Quantity > Typography typography controls. See linked controls

Design > Cart

Setting Purpose and options Behavior
Style Dropdown, Sidebar. Shared
Dropdown Position Left, Center, Right. When: Style ≠ Sidebar. Shared
Sidebar Position Left, Right. When: Style = Sidebar. Shared
Full Screen At Breakpoint. Shared
Full Screen Position Left, Right. When: Full Screen At is set. Shared
Container > Width Width. Responsive
Container > Background Color or supported fill. Shared
Container > Borders borders controls. See linked controls
Container > Padding spacing controls. See linked controls
Top Bar > Typography typography controls. See linked controls
Top Bar > Close Button > Size Size and unit. Responsive
Top Bar > Close Button > Color Color or supported fill. Hover
Top Bar > Close Button > Position Left, Right. Shared
Contents > Max Height Max height and unit. Shared
Contents > Rows > Spacing Spacing and unit. Responsive
Contents > Rows > Separator Color Color or supported fill. Shared
Contents > Rows > Separator Height Separator height and unit. Responsive
Contents > Thumbnails > Size Size and unit. Responsive
Contents > Thumbnails > Opacity Set opacity. Range: 0–1. Hover
Contents > Thumbnails > Borders borders controls. See linked controls
Contents > Remove Icon > Size Size and unit. Responsive
Contents > Remove Icon > Color Color or supported fill. Hover
Contents > Product Title typography controls. See linked controls
Contents > Attributes > Name typography controls. See linked controls
Contents > Attributes > Value typography controls. See linked controls
Contents > Quantity typography controls. When: Dummy Element = dummy. See linked controls
Contents > Price typography controls. See linked controls
Subtotal > Label typography controls. See linked controls
Subtotal > Amount typography controls. See linked controls
Actions > Button > Size > Size Custom, Small, Default, Large. Responsive
Actions > Button > Size > Padding Padding. When: Size = Custom. Responsive
Actions > Button > Size > Override Width Override width and unit. Shared
Actions > Button > Size > Full Width At Breakpoint. Shared
Actions > Button > Background Color or supported fill. Hover
Actions > Button > Outline On/off. Shared

Shown when Outline is set.

Setting Purpose and options Behavior
Actions > Button > Color Color or supported fill. Hover
Actions > Button > Width Width. Shared
Actions > Button > No Fill On Hover On/off. Shared
Setting Purpose and options Behavior
Actions > Button > Typography typography controls. See linked controls
Actions > Button > Corners Square, Round, Custom. Shared
Actions > Button > Corner Radius Corner radius and unit. When: Corners = Custom. Responsive
Actions > Button > Effects > Transition Duration Transition duration. Responsive
Actions > Button > Effects > Scale On Hover Set scale on hover. Range: 0–3. Responsive
Actions > Button > Effects > Shadow Shadow offset, blur, spread, color. Responsive, Hover
Actions > Button > Icon > Icon Icon. Shared
Actions > Button > Icon > Position Before, After. Shared
Actions > Button > Icon > Size Size and unit. Responsive
Actions > Button > Icon > Color Color or supported fill. Hover
Actions > Button > Icon > Space Before Space before and unit. Responsive
Actions > Button > Icon > Space After Space after and unit. Responsive
Actions > Button > Icon > Hover Transform Hover transform and unit. Shared
Actions > Continue Shopping > Typography typography controls. See linked controls
Actions > Continue Shopping > Icon Icon. Shared
Spacing > After Top Bar After top bar and unit. Responsive
Spacing > After Contents After contents and unit. Responsive
Spacing > After Subtotal After subtotal and unit. Responsive
Spacing > After Button After button and unit. Responsive

Design > Spacing

Setting Purpose and options Behavior
Spacing spacing controls. See linked controls

Design > Advanced

Setting Purpose and options Behavior
Override Global Styles woocommerce global styles. See linked controls

Troubleshooting

The cart panel is empty

Check the current visitor's cart state before changing its content settings.

The panel does not fit on a phone

Review Cart width, positioning, and responsive behavior, including long product names.