AvatarGroup is used to display a collection of user avatars together, typically for showing team members or participants in collaborative features.

Basic Avatar Group

The simplest use case: showing multiple avatars grouped horizontally.

User 3
User 2
User 1

Limiting Displayed Avatars

You can limit the number of avatars shown using the max prop. Additional avatars are collapsed into a counter (e.g. +2).

+2
User 2
User 1

Custom Spacing

Customize the gap between avatars using the spacing prop.

User 3
User 2
User 1

Avatar Variants in Group

You can combine avatar shape variants like rounded and square inside the group.

Default
Square
Rounded

Custom Surplus Renderer

Customize the overflow display using the `renderSurplus` prop for more control over surplus appearance.

+4k