# Avatar

Identity image or fallback with an optional status marker.

Use Avatar to identify a person or account where a compact image or initials aid recognition.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `alt` | `string` | prop | No | `undefined` | Accessible alt text for the image. |
| `icon` | `IconGlyph` | prop | No | `undefined` | Fallback glyph when there is no image and no initials. |
| `initials` | `string` | prop | No | `undefined` | Initials shown when no `src` resolves. Optional once `icon` is a fallback. |
| `size` | `number \| ControlSize` | prop | No | `40` | Outer diameter — a number (px) or a token: sm 32 / md 40 / lg 56. |
| `src` | `string` | prop | No | `undefined` | Image URL. Renders an <img>, falling back to initials / icon on error. |
| `status` | `AvatarStatus` | prop | No | `undefined` | No additional description. |
| `statusLabel` | `string` | prop | No | `undefined` | Accessible presence text. Auto-derived as 'Online' / 'Offline' for `status` 'online' / 'offline'; required (and used verbatim) for the other five `status` values — the aria text is omitted when neither applies. |
| `variant` | `AvatarVariant` | prop | No | `'accent'` | No additional description. |

## Related

- [Eyebrow](/docs/components/eyebrow): Tracked label used above headings.
- [CodeBlock](/docs/components/code-block): Read-only code surface with copy support.
- [Stat](/docs/components/stat): Metric value and caption for KPI compositions.