Avatar

User or entity avatar with image, initials fallback, and size variants.

Example

Props

NameTypeDefaultRequiredDescription
srcstringNoImage URL
altstringNoImage alt text
initialsstringNoFallback initials when no image
size'sm' | 'md' | 'lg''md'NoAvatar size
variant'neutral' | 'primary''neutral'NoBackground color variant for initials

Accessibility

  • Uses role="img" with aria-label for initials fallback
  • Image alt text passed through to <img>

Related Tokens

--avatar-surface--avatar-on-surface--avatar-sm--avatar-md--avatar-lg