← Components/primitives

Avatar

User / entity avatar. Wraps Radix Avatar primitives so image loading fails over to a fallback (text initials, icon, or any node).

primitivesstablea11y: untested2/3 coverageEdit on GitHub ↗
primitives-avatar--defaultOpen all variants →

When to use

  • Display a user's photo with text-initials fallback when the image fails or is loading.
  • Anywhere user / org / team identity needs a compact visual marker (member lists, comment threads, kanban tile assignees, the toolbar profile slot).
  • Compose with `Tooltip` to surface the user's name on hover.

When not to use

  • Generic decorative imagery → use a plain <img>. Avatar carries identity semantics.
  • Stand-alone status indicators → use `Badge` or StatusIndicator (pattern).