# Avatar Group

> A stacked row of user avatars with initials fallback, online/away/offline status dots, an overflow "+N" counter, and a staggered reveal animation.

- Author: [thegridcn](https://21st.dev/@thegridcn)
- Library: The Gridcn
- License: no-license
- Tags: Avatar, Avatar Group, User List
- Live preview: https://21st.dev/@thegridcn/components/avatar-group

## Install

```bash
npx shadcn@latest add "https://21st.dev/r/thegridcn/avatar-group?api_key=$API_KEY_21ST"
```

Requires a 21st API key (generate one at https://21st.dev/mcp) passed as `API_KEY_21ST`. Free accounts get a limited number of installs per day; unlimited on a paid plan — see https://21st.dev/pricing.

Full component directory: https://21st.dev/llms.txt · More like this: https://21st.dev/community/components/s/avatar.md