# Relationship card (/ui/candidate-relationship-card)

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

A person in your network and the roles they fit.

## Props [#props]

| Prop | Type | What it does |
| --- | --- | --- |
| `name` (required) | `ReactNode` | The person's name, a level-3 heading on one truncated line. |
| `avatar` | `ReactNode` | Avatar at the start of the header. |
| `cover` | `ReactNode \| null` | The person's own cover, as media the host owns, softened until the card is hovered. Left out, the kit's stock banner (`CoverBanner`) is drawn in its place, in the theme's colours, so everyone's card is the same height; `null` draws no cover. |
| `coverSeed` | `CandidateCoverSeed` | Deals the stock banner its design, the same one every time: the person's id, say. Left out, the name is the seed where it is plain text. |
| `coverSize` | `CandidateCoverImageSize` | The cover's size, the person's own or the stock one. `compact` caps it at 96px, for a card wide enough that a full 4:1 banner would dwarf it; narrower than 384px it is 4:1 either way. |
| `verified` | `boolean` | Marks a verified contact with a check after the name. |
| `headline` | `ReactNode` | The line under the name, usually the current title. |
| `company` | `ReactNode` | The current company, usually a CurrentCompanyPopover or CurrentCompanyLabel. |
| `location` | `ReactNode` | Where they are, after the company. |
| `actions` | `ReactNode` | Controls at the end of the header, such as a favourite button and a profile link. |
| `signal` | `CandidateRelationshipSignal` |   |
| `facts` (required) | `readonly CandidateRelationshipFact[]` | Up to three facts, in a row that stacks on narrow screens. |
| `suggestion` | `CandidateRelationshipSuggestion` |   |
| `note` | `CandidateRelationshipNote` |   |
| `selected` | `boolean` | Selected treatment, and aria-current. |
| `onSelect` (required) | `() => void` | Called when the card is activated, but not from a click on a nested control. |

## Data it needs [#data-it-needs]

On the Kith data layer, a relationship card reads a person's record, notes and suggested roles. With your own backend, pass the same values and callbacks.

It shows [`CandidateRelationship`](/api/reference/objects/candidate-relationship) 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 build a network view of relationship cards with signals and suggested roles.
```