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

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

Roles grouped by employer, with dates.

## Props [#props]

### CandidateCareerHistoryTimeline [#candidatecareerhistorytimeline]

| Prop | Type | What it does |
| --- | --- | --- |
| `items` (required) | `readonly CareerHistoryItem[]` |   |
| `loading` | `boolean` |   |
| `empty` | `CandidateEmptyCopy` | The blank slate's wording. Defaults to "No career history yet". |
| `emptyTitle` | `string` |   |
| `emptyDescription` | `string` |   |
| `earlierLabel` | `ReactNode` |   |
| `presentLabel` | `ReactNode` |   |
| `detailedCompanyGroups` | `number` |   |
| `locale` | `string` |   |
| `titleLevel` | `CareerHistoryTitleLevel` | The heading level of each role's title: 5 (the default), or 3, 4 or 6 to sit one under whatever heads the history, so a page's outline skips no level. Only the tag changes: a title looks the same at every level. When it is given, the "Earlier" label is said at the same level. |
| `className` | `string` |   |

### CareerDateRange [#careerdaterange]

| Prop | Type | What it does |
| --- | --- | --- |
| `start` | `CalendarDateValue` |   |
| `end` | `CalendarDateValue` |   |
| `current` | `boolean` |   |
| `presentLabel` | `ReactNode` |   |
| `locale` | `string` |   |

## 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 timeline to a candidate's profile.
```