Design System
Data display

Avatar group

Several avatars overlapped into one cluster, with a plus-N count once they exceed the limit.

Not documented yet

This component ships in the design system and is fully supported. What is missing is the guidance around it: when to reach for it, the do and don't, and the accessibility notes. Until that is written, Storybook is the reference for variants, props and live controls.

Props

PropTypeDefaultDescription
itemsrequiredAvatarGroupItem[]
maxnumber | undefined4Avatars shown before collapsing the rest into a “+N” count.
sizenumber | undefined32Avatar diameter in pixels.

On this page