Avatar Group

v1.2.0

Stacks overlapping avatars in a compact row.

Core Controls

Orientation Track

Scale Uniform

Display Cap (3)

Use the controls to customize the appearance.

Avatars stack vertically for sidebar layouts.

API Reference

All available props for this component.

Property	Type	Default	Description
orientation	'horizontal' \| 'vertical'	'horizontal'	Sets the visual track direction and dynamically reverses layer alignment indices.
size	'sm' \| 'md' \| 'lg' \| 'xl'	'md'	Configures uniform height and width dimensions across all embedded profiles.
max	number	4	The ceiling threshold of visible profiles before dropping additional nodes into a trailing incremental counter.
roundness	'none' \| 'sm' \| 'md' \| 'lg' \| 'full'	'full'	Controls the perimeter mask radius of individual avatars and the backup count bubble.