Decision reason dialog
Asks why before a decision on a candidate is recorded, with one-tap suggestions to start the reason.
What it shows
Asks why before a decision is recorded.
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
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
Install RecruiterOS/recruit-ui and add a dialog that asks for a reason before a candidate is rejected.