# Card list (/ui/candidate-card-list)

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

A searchable grid of your candidate cards.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `getItemKey` (required) | `(item: T, index: number) => Key` | A stable key for each item's card. |
| `columnsViewId` (required) | `string` | Where the cards-per-row choice is remembered; see useCandidateCardColumns. |
| `columnsLabels` | `Partial<CandidateCardColumnsToggleLabels>` |   |
| `scrollNavigation` | `{ label?: string; topOffset?: number; getItem: (item: T, index: number) => Pick<ScrollNavigatorItem, "label" \| "imageSrc" \| "fallback">; }` | Optional avatar navigation for the cards currently visible after filtering. |

## 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 a searchable list of candidate cards, one or two per row.
```