Skip to content
Agent UI
PrimitivesAvatar

Avatar

Image avatar with a stable, accessible fallback. Import from @agent-ui/react or a direct subpath. Tailwind CSS v4 theme tokens are required.

Avatar ships with a full API table, a copyable example, and accessibility notes.

tsx

Installation

Install the package once, then import Avatar from its direct entry point or from the root.

bash
pnpm add @agent-ui/react
tsx
import { Avatar } from "@agent-ui/react/avatar";

Tailwind CSS v4 users: add @source "../node_modules/@agent-ui/react/src" to the global stylesheet so the library utilities are generated.

Usage

The example below is the same code that renders the preview. Copy it, swap in your own handlers, and ship.

tsx
import { Avatar } from "@agent-ui/react";
 
<Avatar alt="Ada Lovelace" fallback="AL" />

API reference

Every prop Avatar accepts, its type, default, and behaviour.

API reference for this component
NameTypeDefaultDescription
srcReact prop—Configuration exposed through the component's public React props.
altReact prop—Configuration exposed through the component's public React props.
fallbackReact prop—Configuration exposed through the component's public React props.
sizeReact prop—Configuration exposed through the component's public React props.

Accessibility

Uses native HTML semantics, keyboard controls and visible focus styles where applicable.
Use it with the rest of the library

Avatar composes with MessageList, ChatShell, useChat, and the provider compose blocks. Browse the full reference or see all components in the gallery.

3 lines · copy-ready