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