# Cover header (/ui/candidate-cover-header)

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

A cover and an identity, as cards and profiles share them.

## Props [#props]

### CandidateCoverHeader [#candidatecoverheader]

| Prop | Type | What it does |
| --- | --- | --- |
| `cover` | `ReactNode` | Host-owned media for the 4:1 frame. `null` draws no cover, whatever `coverFallback` says. |
| `coverFallback` | `CandidateCoverFallback` | What stands in when `cover` is left out. `stock` draws the kit's `CoverBanner` in the frame: a banner in the theme's own colours, so someone with no cover is the same height as their neighbours. `none`, the default here, draws no frame; the cards and profiles that always show a cover pass `stock`. A stock cover isn't printed: it sits in a `data-slot="candidate-cover-stock"` wrapper that paper leaves out. |
| `coverSeed` | `CandidateCoverSeed` | Deals the stock cover its design. Left out, everyone gets the first. |
| `coverSize` | `CandidateCoverImageSize` | The cover's size; the default keeps its full 4:1 ratio. |
| `children` (required) | `ReactNode` |   |
| `padding` | `CandidateCoverHeaderPadding` | Space around the identity. `none` sits it flush in a container the host pads; with no cover the header then doesn't clip, so a focus ring at its edge stays whole. `dialog` pads it like the kit's dialog header (16px), so as a CandidateProfileDialog's `header` it starts at the body's left edge. |
| `softenCoverUntilHover` | `boolean` |   |

### CandidateCoverImage [#candidatecoverimage]

| Prop | Type | What it does |
| --- | --- | --- |
| `children` | `ReactNode` | Caller-owned media. The host owns source resolution and alt text. |
| `size` | `CandidateCoverImageSize` | `compact` keeps the 4:1 ratio until the frame reaches 96px high. |
| `softenUntilHover` | `boolean` |   |

## 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 [`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 add a cover header with an avatar and a name to my own candidate card.
```