AvatarGroup
Display member avatars together, with text fallbacks and overflow counts. Use Avatar for each member.
Basic usage
Place member avatars inside AvatarGroup and provide each member name through Avatar.alt.
Text avatar colors distinguish members; they do not indicate status.
Examples
Sizes
Use AvatarGroup.size to set the size of avatars in the group.
Image avatars
Provide the member's name through alt, including when only initials are visible.
Fallbacks and defaults
Failed images fall back to children, icon or the default icon. Changing the image source retries loading.
Avatar group overflow
Set maxCount to limit visible members, then use +N to view the remaining members.
Shapes
Use Avatar.shape to choose circular or square avatars.
API
AvatarGroup API
Props for displaying member avatars as a group with overflow counts.
AvatarGroupProps API
Avatar API
Props for an individual member avatar within a group.