# Filter chips (/ui/candidate-filter-chips)

## What it shows [#what-it-shows]

Chips that narrow a list of people to one kind.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `value` (required) | `TValue \| null` | The chosen option, or null for the unfiltered chip. |
| `onChange` (required) | `(value: TValue \| null) => void` | Called with an option's value, or null from the unfiltered chip. |
| `allLabel` (required) | `ReactNode` | The first chip, which clears the filter, such as "Everyone". |
| `options` (required) | `readonly CandidateFilterChipOption<TValue>[]` |   |
| `context` | `ReactNode` | Content before the chips, such as a badge naming where the list came from. |
| `action` | `ReactNode` | Content pushed to the end of the row, such as a related control. |

## Data it needs [#data-it-needs]

The component takes plain values and callbacks and keeps no records of its own. Pass it yours, from the Kith data layer or from a backend you already run.

## Copy to your agent [#copy-to-your-agent]

```text title="Copy to your agent"
Install RecruiterOS/recruit-ui and add filter chips that narrow my network view to one kind of change.
```