# filter-swatches

> Facet as swatch buttons painted from the value's native swatch; a click toggles the value.

Status: Ready (Smootify 2.0)  
Add-on: Search & discovery  
URL: https://www.smootify.io/docs/astro/reference/elements/filter-swatches  
Updated: 2026-10-21

## Where it can go

- **Inside** [`smootify-search-discovery`](https://www.smootify.io/docs/astro/reference/elements/smootify-search-discovery).
- **Must contain** `form`, `button`.
- **Out of place,** Smootify removes it from the page: also without a label attribute; data-expand panels count as inside.

## What it requires

- The **Search & discovery** extension (lite or server plan, or the extension activated in the Smootify dashboard). Without it, the element does nothing.

## Attributes on the element

- **It reads** `label`, `custom-label`, `selected-value`, `allow-reset`, `show-count`, `hide-parenthesis`, `multiple`.

## Attributes inside it

| Group | Attribute name | Values |
|---|---|---|
| [Filter swatch](https://www.smootify.io/docs/astro/reference/attributes/filter-swatch) | `swatch` | 4 |

## Loading

Its code loads only on pages that have `filter-swatches`.