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

Grade badge

A grade letter with your own label and tone, plus helpers that normalise and format grades.

What it shows

A grade letter with your own label and tone.

Props

PropTypeWhat it does
grade (required)string | null | undefined
labelReactNodeOne-off host wording. Takes precedence over labels. With no grade, the inline format shows it alone, such as "Needs review", in place of the dash.
labelsCandidateGradeLabelsHost-owned wording map for shared badge instances.
toneCandidateGradeToneHost-owned semantic treatment; no meaning is inferred from the letter.
showLabelboolean
sizeBadgeProps["size"]The kit badge size, such as compact for dense rows.
as"div" | "span"Root element: a block-level div (default) or an inline span.
shrinkbooleanKeep the badge at its natural width in a flex row.
format"split" | "inline"split (default): the letter and the label as separate spans, the letter with an accessible name. inline: a single line of text, "A — Strong fit", for a host that names the grade in a tooltip or the surrounding text; with no grade, the label alone, or "—" without one.
appearance"badge" | "sentiment"badge (default): the kit Badge in tone. sentiment: the kit's sentiment pill, a coloured dot and text, in sentiment. The pill takes only className; other attributes are not passed to it.
sentimentCandidateGradeSentimentHost-owned sentiment for appearance="sentiment".

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.

It shows JobCandidate from the Kith ATS API.

Copy to your agent

Copy to your agent
Install RecruiterOS/recruit-ui and add a grade badge with my own labels to each candidate card.