# Grade badge (/ui/candidate-grade)

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

A grade letter with your own label and tone.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `grade` (required) | `string \| null \| undefined` |   |
| `label` | `ReactNode` | One-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. |
| `labels` | `CandidateGradeLabels` | Host-owned wording map for shared badge instances. |
| `tone` | `CandidateGradeTone` | Host-owned semantic treatment; no meaning is inferred from the letter. |
| `showLabel` | `boolean` |   |
| `size` | `BadgeProps["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`. |
| `shrink` | `boolean` | Keep 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. |
| `sentiment` | `CandidateGradeSentiment` | Host-owned sentiment for `appearance="sentiment"`. |

## 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.

It shows [`JobCandidate`](/api/reference/objects/job-candidate) from the [Kith ATS API](/api).

## Copy to your agent [#copy-to-your-agent]

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