# Activity timeline (/ui/candidate-activity-timeline)

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

A person's history, grouped by period.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `groups` (required) | `readonly CandidateActivityGroup[]` | The periods, in order, usually newest first. Empty groups are left out. |
| `loading` | `boolean` | Skeleton rows in place of the timeline. |
| `empty` | `CandidateEmptyCopy` | The blank slate's wording. Defaults to "No activity yet". |
| `spacing` | `TimelineProps["spacing"]` | The kit Timeline's spacing between rows in a period. Defaults to `tight`. |
| `labels` | `Partial<CandidateActivityTimelineLabels>` |   |

## 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 an activity timeline of calls, emails and notes to a candidate's detail pane.
```