# Profile (/ui/candidate-profile)

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

Identity, career history and contact channels.

## Props [#props]

### CandidateProfile [#candidateprofile]

| Prop | Type | What it does |
| --- | --- | --- |
| `header` | `ReactNode` |   |
| `children` (required) | `ReactNode` |   |
| `footer` | `ReactNode` |   |
| `printMode` | `CandidateProfilePrintMode` | `default` prints the card as it looks on screen. `flat` prints it without its border (or a shadow a host gave it), so a printed profile reads as a page rather than a card on one. |

### CandidateProfileHeader [#candidateprofileheader]

| Prop | Type | What it does |
| --- | --- | --- |
| `name` (required) | `ReactNode` |   |
| `avatar` | `ReactNode` |   |
| `cover` | `ReactNode \| null` | The person's own cover, as media the host owns. Left out, the kit's stock banner (`CoverBanner`) is drawn in its place, in the theme's colours; `null` draws no cover. A flush header (`padding="none"`) never draws the stock one: it sits inside a container the host pads, where a banner couldn't reach the edges. |
| `coverSeed` | `CandidateCoverSeed` | Deals the stock banner its design, the same one every time: the person's id, say. Left out, the name is the seed where it is plain text. |
| `coverSize` | `CandidateCoverImageSize` | The cover's size, the person's own or the stock one. `compact` caps it at 96px, for a card wide enough that a full 4:1 banner would dwarf it; narrower than 384px it is 4:1 either way. |
| `eyebrow` | `ReactNode` |   |
| `status` | `ReactNode` |   |
| `meta` | `ReactNode` |   |
| `summary` | `ReactNode` |   |
| `actions` | `ReactNode` |   |
| `actionsPlacement` | `CandidateProfileHeaderActionsPlacement` | Where `actions` sit. `name` (the default) puts them on the name line, at its end, with the meta running under them. `aside` gives them a column of their own beside the whole identity, top-aligned, so a control taller than the name's line doesn't push the meta away from the name. |
| `padding` | `Extract<CandidateCoverHeaderPadding, "lg" \| "dialog" \| "none">` | `lg` (the default) pads the header like a card's. `dialog` pads it like the kit's dialog header, so as a CandidateProfileDialog's `header` the name starts at the body's left edge, in line with what the body holds. `none` sits it flush in a container the host already pads, such as a drawer body. |
| `titleLevel` | `CandidateProfileHeaderTitleLevel` | The name's heading level. 1 (the default) suits a profile that is the page. 2, 3 or 4 suit one inside something that already has the page's h1, such as a dialog over a page or a section of one. Only the tag changes: the name looks the same at every level. |

### CandidateProfileFooter [#candidateprofilefooter]

| Prop | Type | What it does |
| --- | --- | --- |
| `children` (required) | `ReactNode` |   |
| `justify` | `CandidateProfileFooterJustify` | Where the row's content sits along it. `start` by default. |
| `padding` | `CandidateProfileFooterPadding` | The kit PanelSection's padding: `default` (26px) for a row of actions, `compact` for a single line such as a credit. |
| `printVisibility` | `CandidateProfileFooterPrintVisibility` | `hidden` leaves the footer off a printed profile. |

## Data it needs [#data-it-needs]

On the Kith data layer, a profile reads a candidate's record. With your own backend, pass the same values.

It shows [`Candidate`](/api/reference/objects/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 build a candidate profile page with a header and career history.
```