# Cart count

<figure><img src="/files/bMnydlHlI2RgmVx0A63B" 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> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.brickspacelab.com/slab/content/blocks/cart/cart-count.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.