---
title: Text filter
description: Filter data with free text.
---

A text filter accepts one text value. Backlit removes whitespace from the start
and end. Empty text does not apply a filter.

## API

```ts
filters.text(name: string): TextFilterBuilder
```

| Method     | Input    | Result                         |
| ---------- | -------- | ------------------------------ |
| `setLabel` | `string` | Sets the filter-control label. |

## Basic text filter

Use a text filter for a search term or another free-text query.

<BacklitExample path="filters/text/basic" view="list" />