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

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

Asks why before a decision is recorded.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `open` (required) | `boolean` |   |
| `title` (required) | `ReactNode` | Names the decision and who it is about, such as "Reject: Mei Tanaka", or "Reject 12 candidates" for a decision on several people at once. |
| `suggestions` | `readonly string[]` | One-tap reasons, already worded. Tapping one adds it to the reason. |
| `placeholder` (required) | `string` |   |
| `confirmLabel` (required) | `ReactNode` |   |
| `confirmTone` | `"default" \| "destructive"` | `destructive` for a rejection, `default` to move forward. |
| `reasonOptional` | `boolean` | Lets the decision be confirmed with no reason, for a quick decision where a reason helps but mustn't slow it down, such as one on several people at once. The reason is required without it. |
| `onSubmit` (required) | `(reason: string) => Promise<void>` | Called with the trimmed reason, which is an empty string when `reasonOptional` let the person confirm without one. The confirm button shows a spinner and the dialog's buttons stay disabled until it settles; the host closes the dialog once the decision is saved. |
| `onClose` (required) | `() => void` | Called from Cancel, Escape and the close button. |
| `labels` | `Partial<CandidateDecisionReasonDialogLabels>` |   |
| `id` | `string` | The reason field's id. A generated one is used when omitted. |

## 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 dialog that asks for a reason before a candidate is rejected.
```