Skip to content
Component

Avatar

Circular avatar (wraps Base UI Avatar) with an automatic initials fallback, plus Avatar Group for overlapping stacks.

Sizes

KYKYKY

Image, initials, and icon fallback

KYAC
  • Fallback shows automatically while the image loads or on error; it accepts initials or any icon node

With status

Composed with a small positioned dot, the same pattern as Status Indicator.

KY

Avatar Group

ABC+1
  • max caps how many overlap before collapsing into a +N indicator

Avatar Group: sizes

ABC
AB+1

API reference

src / fallbackNone
string | ReactNode

Image source and accessible fallback.

size"md"
"sm" | "md" | "lg"

Avatar dimension.

tone"default"
ComponentTone

Background/text color behind the fallback content.

classNameNone
string

Additional classes applied to the component root.