# Pipeline list (/ui/candidate-pipeline-list)

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

The roles a person is in the pipeline for.

## Props [#props]

### CandidatePipelineList [#candidatepipelinelist]

| Prop | Type | What it does |
| --- | --- | --- |
| `title` | `ReactNode` | The section heading. The count follows it once loaded. |
| `rows` (required) | `readonly CandidatePipelineRow<TStage>[]` |   |
| `loading` | `boolean` | A skeleton control in place of the rows, and no count yet. |
| `action` | `ReactNode` | At the end of the header, such as an add-to-role control. |
| `empty` | `CandidateEmptyCopy` | The blank slate's wording. Defaults to "No roles yet". |
| `labels` | `Partial<CandidatePipelineListLabels>` |   |
| `border` | `"none" \| "top" \| "bottom"` | The kit PanelSection's divider. |

### CandidateSummaryBullets [#candidatesummarybullets]

| Prop | Type | What it does |
| --- | --- | --- |
| `bullets` (required) | `readonly CandidateSummaryBullet[]` | The lines to show; the host may fall back to other evidence when there is no summary. |
| `presentation` | `"compact" \| "body"` | Compact pipeline text by default; body uses the small body scale and inherits its surrounding text tone. |
| `onGenerate` | `() => void` | Adds a link-style button that asks the host for a summary. |
| `generating` | `boolean` | Shows a spinner on the button and disables it. |
| `generated` | `boolean` | Says refresh instead of generate, once a summary exists. |
| `error` | `ReactNode` | Why the last request failed. |
| `labels` | `CandidateSummaryBulletsLabelOverrides` |   |

## 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 [`JobCandidate`](/api/reference/objects/job-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 list of the roles a person is in the pipeline for, with a stage select on each.
```