# Decision reason sheet (/ui/candidate-decision-reason-sheet)

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

The voice-first Why? after a Yes or a No.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `open` (required) | `boolean` |   |
| `onClose` (required) | `() => void` | Called from the close button and Escape. Nothing is decided. |
| `decision` | `CandidateDecisionChoice` | The answer being explained. It only words the defaults ("Why no?", "Skip — just mark No"): the sheet neither holds nor saves a decision, so leave it out for any other question and pass the wording yourself. |
| `candidateName` | `string` | The candidate's name, for the default wording only. |
| `title` | `ReactNode` | The question, as the sheet's heading and its accessible name. |
| `subtitle` | `ReactNode` | The line under the question, which also describes the sheet to a screen reader. |
| `voiceTitle` | `string` | The dictation overlay's title, such as "Why no on Mei Tanaka?". |
| `reasons` | `readonly string[]` | One-tap reasons, already worded. Picking one confirms with it. |
| `onConfirm` (required) | `(reason?: string) => unknown` | Called with the reason a person spoke, typed or picked, trimmed, or with none when they skipped. The host saves the decision and closes the sheet. It may return a promise: while that is pending the sheet shows `labels.saving` in place of the composer and Skip is disabled, though the sheet can still be closed; if it rejects, the composer comes back with a typed or spoken reason still in it and `labels.failed` under it. |
| `reasonRequired` | `boolean` | Takes Skip away, so the only ways out are a reason or the close button. A reason is optional without it: encouraged, never demanded. |
| `skipLabel` | `ReactNode` | Skip's wording, such as "Skip — just reject Mei Tanaka". |
| `footer` | `ReactNode` | Host content over the bottom row, such as a switch that changes what the decision does. Its state stays the host's, read when `onConfirm` runs. |
| `actions` | `ReactNode` | Host controls in the bottom row, before Skip, such as another way to decide. |
| `voice` | `boolean` | `false` leaves dictation out, and the sheet opens on the typed reason. It also opens there wherever dictation can't run. |
| `voiceLang` | `string` | The language dictation listens for, as a BCP 47 tag. |
| `labels` | `Partial<CandidateDecisionReasonSheetLabels>` |   |

## 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 voice-first sheet that asks why after a yes or a no on a candidate.
```