# Cart count

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-9e2b16c7c420141897ffc028cbdfd0aae49c9ab0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

Displays a cart count indicator that shows the current number of items in the cart. Can be displayed inline or as a floating badge with configurable position. The count is dynamically updated using Alpine.js.

## Common use cases

* For floating layout, adjust x/y positions to align properly with your cart icon
* Consider visibility settings for responsive designs when using multiple cart icons
* Display cart item count in headers or navigation areas
* Use as a badge overlay on cart icons

## Block settings

### General

| Setting                | Description                 | Options                   |
| ---------------------- | --------------------------- | ------------------------- |
| Show advanced settings | Reveals visibility settings | Checkbox (default: false) |

### Content

| Setting     | Description                                                                     | Options                   |
| ----------- | ------------------------------------------------------------------------------- | ------------------------- |
| Digit limit | Maximum number of digits to display before showing "+" suffix (e.g., 2 = "99+") | Number input (default: 2) |

### Color

| Setting      | Description                               | Options                                                                                                                                                   |
| ------------ | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Button color | Color scheme for the cart count indicator | <p>• Primary (default)<br>• Secondary<br>• Tertiary<br>• Neutral<br>• Plain<br>• Outline<br>• Inverted outline<br>• Blur<br>• Link<br>• Inverted link</p> |

### Style

| Setting     | Description                                 | Options                                                                                                                                                           |
| ----------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Controls the font family used for the count | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when font size contains 'type--'</p>                                                        |
| Font size   | Controls the font size of the count         | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |
| Radius      | Border radius for the count indicator       | <p>• None<br>• Default (default)<br>• SM<br>• MD<br>• LG<br>• XL<br>• 2XL<br>• Full</p>                                                                           |

### Layout

| Setting             | Description                                          | Options                                                              |
| ------------------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
| Layout              | Controls the layout of the count indicator           | <p>• Float<br>• Inline (default)</p>                                 |
| Horizontal position | Horizontal position as percentage (for float layout) | <p>0 - 100 % (default: 55)<br><br>Visible when layout is "float"</p> |
| Vertical position   | Vertical position as percentage (for float layout)   | <p>0 - 100 % (default: 0)<br><br>Visible when layout is "float"</p>  |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |