Components
Avatar Group
Overlapping facepile; extra people collapse into a “+N” chip.
ALGHLT+2
Usage
Use it to:
- show who is on a page, project or thread at a glance
Don’t use it to:
- a full member list (use a list with names)
Installation
Install the package (React 19):
terminal
terminal
terminal
Import the styles once, in your app entry or root layout:
/src/main.tsx
Use it anywhere inside your app's <Theme> (see Installation):
/src/AvatarGroupExample.tsx
Examples
Size
AGL
AGL
AGL
AGL
AGL
Workspaces
Children default to the circular user shape; set shape to keep squares.
DTE
Dark theme
AG+1
API Reference
AvatarGroup
A <div role="group">; supports all of its props. Adds:
| Prop | Type | Default |
|---|---|---|
max | number | 4 |
size | "xs""sm""md""lg""xl"1620242832 | "md" |
Accessibility
- A
group; each avatar is an image named after its person, and the chip is named “N more”. - Add
aria-labelto the group (“Collaborators”) when its purpose is not clear from context.
© 2026 Motion. Internal documentation.