New: Kith open-sources its ATS.Read why
Skip to Content

Decision reason sheet

The voice-first “Why?” asked once a reviewer has said Yes or No: speak the reason, tap a suggested one, type it, or skip.

What it shows

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

Props

PropTypeWhat it does
open (required)boolean
onClose (required)() => voidCalled from the close button and Escape. Nothing is decided.
decisionCandidateDecisionChoiceThe 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.
candidateNamestringThe candidate's name, for the default wording only.
titleReactNodeThe question, as the sheet's heading and its accessible name.
subtitleReactNodeThe line under the question, which also describes the sheet to a screen reader.
voiceTitlestringThe dictation overlay's title, such as "Why no on Mei Tanaka?".
reasonsreadonly string[]One-tap reasons, already worded. Picking one confirms with it.
onConfirm (required)(reason?: string) => unknownCalled 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.
reasonRequiredbooleanTakes Skip away, so the only ways out are a reason or the close button. A reason is optional without it: encouraged, never demanded.
skipLabelReactNodeSkip's wording, such as "Skip — just reject Mei Tanaka".
footerReactNodeHost 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.
actionsReactNodeHost controls in the bottom row, before Skip, such as another way to decide.
voicebooleanfalse leaves dictation out, and the sheet opens on the typed reason. It also opens there wherever dictation can't run.
voiceLangstringThe language dictation listens for, as a BCP 47 tag.
labelsPartial<CandidateDecisionReasonSheetLabels>

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
Install RecruiterOS/recruit-ui and add a voice-first sheet that asks why after a yes or a no on a candidate.