# Career history panel (/ui/candidate-career-history-panel)

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

A career history under a counted header.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `title` | `ReactNode` | The section heading, "Career history" by default. The count of roles follows it once loaded. |
| `items` (required) | `CandidateCareerHistoryTimelineProps["items"]` |   |
| `loading` | `boolean` | Skeleton rows while there are no items yet. |
| `empty` | `CandidateEmptyCopy` | The blank slate's wording. Defaults to "No career history yet". |
| `detailedCompanyGroups` | `number` | Passed to the timeline: how many employer groups keep their descriptions. |
| `locale` | `string` |   |
| `scroll` | `"viewport" \| "none"` | `viewport` (the default) caps the timeline at the viewport's height in a scroll area of its own, for a popover or a narrow side panel. `none` lets it run at full height, for a container that already scrolls, such as a profile dialog's body, so the history never scrolls inside the body. |

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

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

```text title="Copy to your agent"
Install RecruiterOS/recruit-ui and add a career history panel to a candidate's profile.
```