Components/Media
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/avatargroup
AvatarGroup allows to display a number of avatars (digital representation of a user) as a single entity. It's a building block grouping number of standalone <Avatar/> components.
<Image/>)Controls size of a component. It supports 3 sizes: - `medium` (default)- use in all common cases - `small` - use to de-emphasise the group, also in more dense and narrow layouts - `tiny`
Changes density of a group. Component supports 2 types: - `stretched` (default)- use when each user is as important as a group as a whole - `condensed` - use in narrow layouts and in cases where it is important to show the sum of the people rather than individuals
Separates first avatar from the rest of the group to highlight the difference of a status or role (i.e. admin, team lead, etc). Component allows to separate single avatar only, which must be a first item on the list.
Defines the maximum number of items to show before collapsing them. By default component displays up to 5 items. The '+N' indication will replace the last avatar, in case the number exceeds this limit.
Use avatar group to display multiple users that are assigned to the same role, group or task.
| Name | Type | Default | Description |
|---|---|---|---|
dataHook | string | — | Applies a data-hook HTML attribute that can be used in the tests. |
items (required) | AvatarItemProps[] | — | Use to pass an array of avatars. |
maxItems | number | 5 | Sets the maximum number of avatars to be displayed. Avatars that exceed this limit are hidden under the "+N" item. |
showDivider | boolean | — | Separates the first avatar with a divider from the rest of the group. |
size | "small" | "tiny" | "medium" | — | Changes the size of avatars in the group. |
type | "stretched" | "condensed" | — | Changes the way avatars are displayed inside the group. |
Import the driver matching your test environment:
| Method | Description |
|---|---|
getVisibleAvatarsCount | Gets the number Of displayed Avatars |
getVisibleAvatarTextContentByIndex | Gets the text content |
getMoreIndicatorContent | Gets the moreIndicator content |
isMoreIndicatorExist | Checks whether the moreIndicator exists |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
AvatarItemProps type, so the type of the items array entries can be imported directly from @wix/design-system. (#16903)--wds-avatar-group-counter-* theme tokens. In BM Reimagined (Harmony) and Studio 2.0 it renders per the Figma definition — translucent fill with a subtle gradient, frosted-glass backdrop blur, and a 1px border — while the default, Studio, and Wixel themes keep their existing appearance (the circle's overall size is preserved via border-width padding compensation). (#16694) — has visual changesLast updated: 22 October 2026