> For the complete documentation index, see [llms.txt](https://2600hz.gitbook.io/sds/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://2600hz.gitbook.io/sds/sds-3.0/sds-components/components/avatargroup.md).

# AvatarGroup

An AvatarGroup component is a user interface element used to display a group or collection of avatars together in a compact layout.

### Use Cases:

✅ Displaying a group of user avatars in a compact and visually appealing manner.

✅ Showing a list of participants or members in a team, chat, or social group.

✅ Indicating the presence of multiple users or entities associated with a certain action or event.

### Not to Use Cases:

❌ Using AvatarGroup for a single avatar display - AvatarGroup is designed for displaying multiple avatars together, so using it for a single avatar would be unnecessary.

❌ Overloading AvatarGroup with a large number of avatars, causing visual clutter or performance issues - The number of avatars should be kept within a reasonable range to maintain readability and performance.

❌ Using AvatarGroup as an interactive component with individual avatar actions - AvatarGroup is meant to display avatars collectively and should not be used for individual interactions or actions.