# Card columns toggle (/ui/candidate-card-columns-toggle)

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

One or two cards per row, remembered.

## Props [#props]

### CandidateCardColumnsToggle [#candidatecardcolumnstoggle]

| Prop | Type | What it does |
| --- | --- | --- |
| `columns` (required) | `CandidateCardColumns` |   |
| `onChange` (required) | `(columns: CandidateCardColumns) => void` |   |
| `roomy` | `boolean` | Larger controls, to sit beside a roomy toolbar. |
| `labels` | `Partial<CandidateCardColumnsToggleLabels>` |   |
| `className` | `string` |   |

### useCandidateCardColumns, what it returns [#usecandidatecardcolumns-what-it-returns]

| Prop | Type | What it does |
| --- | --- | --- |
| `columns` (required) | `CandidateCardColumns` |   |
| `setColumns` (required) | `(columns: CandidateCardColumns) => void` |   |

## 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 one or two column toggle to a grid of candidate cards.
```