Skip to content
Component

Avatar Group

An overlapping stack of avatars with a “+N” tile once the list runs past its limit. Earlier avatars sit above later ones, so the overflow tile tucks under the last face.

Basic

ABC+1
  • max caps how many overlap before collapsing into a +N indicator

Sizes

ABC
AB+1

Photos

With real faces the ring reads as each avatar being cut out of the one beneath it, rather than a line drawn across a neighbour.

+1
  • The separating ring uses the colour of the surface behind the group; override it with --fuji-avatar-group-ring when the group sits on something other than a Card

On a tinted surface

Set --fuji-avatar-group-ring when the group is not on the default surface, so the cut-out still matches what is behind it.

API reference

avatars *None
AvatarProps[]

Each face, in stacking order. Earlier entries sit above later ones.

max4
number

How many faces to show before the rest collapse into a "+N" tile.

size"md"
ComponentSize

Diameter applied to every avatar in the group.

Also accepts everything from React.HTMLAttributes<HTMLDivElement>.

Coding agents read this reference, with its examples, from the version your project has installed, through the Fuji UI MCP server. Set up your agent