# filter-search

> Free-text query of the block; typing or submitting sets the search query, also in a collection (data-collection).

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

## At a glance

| Element | Built with | Label | The visitor picks |
|---|---|---|---|
| `filter-checkbox` | a Form Block with one Checkbox | `label="Color"` | several values |
| `filter-list` | a Form Block with one Radio button | `label="Size"` | one value |
| `filter-select` | a Form Block with a Select field | `label="Material"` | one value |
| `filter-dropdown` | a Form Block and a Webflow Dropdown | `label="Material"` | one value |
| `filter-popover` | a Form Block and a popover with links or buttons | `label="Material"` | one value |
| `filter-swatches` | a Form Block and one Custom element with the tag `button` | `label="Color"` | one value, or several with `multiple="true"` |
| `filter-price` | a Form Block with two number fields and two sliders | none: it reads no label | a price range |
| `filter-search` | a Form Block with a Text field | none: it reads no label | words to search |

More in [the guide](https://www.smootify.io/docs/build/filters).

## Where it can go

- **Inside** [`smootify-search-discovery`](https://www.smootify.io/docs/reference/elements/smootify-search-discovery).
- **Must contain** `form`.
- **Out of place,** Smootify removes it from the page: 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.

## Fields in the form

Each field’s **Name** setting in Webflow tells Smootify what the field holds. It is a setting of the field, not a custom attribute.

| Name | Field | What it does |
|---|---|---|
| every input but the submit (any name) | Text field | Renamed `query`; the first one sets the search & discovery query. |

## Loading

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