# Sourcing trace (/ui/sourcing-trace)

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

How a sourcing run went, a line per step.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `steps` (required) | `readonly SourcingTraceStep[]` | The run's steps, in order. With none, nothing is drawn. |
| `agentName` (required) | `string` | Who did the work, for the run's name ("How Scout searched"). |
| `live` | `boolean` | The run under way: every step shows, as reported. Any other run (finished, gone quiet or overtaken) folds into one line that opens to its steps, a step it left pending or running shown stopped. |
| `labels` | `Partial<SourcingTraceLabels>` |   |
| `markdownComponents` | `MarkdownComponents` | Per-element overrides for the steps' Markdown detail, such as a host's heading face. |

## 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 trace of each sourcing run's steps to my search page.
```