Updated: July 15, 2024

Avatar Group

ui5-avatar-group | v1.0

Intro

The avatar group displays several avatars together, indicating that more than one person or business entity is associated with an item.

Avatar group (group view) – live example

Avatar group (individual view) – live example

When to Use

Do

Use the avatar group:

  • To display a group of at least two people or items.
  • To display several people or items that have something in common (such as people in the same team or project).
Don't

Don’t use the avatar group:


  • To display a gallery for simple images. Use the carousel instead.
  • To display a single avatar.
  • To show visual content other than avatars.

Anatomy

  1. Avatar group (type: individual or group)
  2. Avatar
  3. Overflow button
Anatomy of an avatar group (type: individual)
Anatomy of an avatar group (type: individual)
Anatomy of an avatar group (type: group)
Anatomy of an avatar group (type: group)

Variants

There are two types of avatar group:

  • Group: Combined focus for all avatars in the group (default)
  • Individual: Focus on each avatar

Both types are always displayed horizontally.

You can adjust the order of the avatars. For example, the sequence can be alphabetical, history-based, or random.

Note: The avatar group reuses the avatar component and its logic. If a person’s image isn’t available, the avatar displays the person’s initials. If there are more than 3 initials or the language system doesn’t support initials, the avatar displays a gender-neutral person icon.

Avatar group (type: group) – live example with slider

Avatar group (type: individual) – live example with slider

Behavior and Interaction

The avatar and avatar group support click events.

Individual type (focus on one avatar):

  • Clicking an avatar displays a popover with the details for that avatar.
  • Clicking the overflow icon displays a popover showing the avatars hidden in the overflow.

Details for an individual avatar / avatars in the overflow – live example

Group type (focus on the entire avatar group):

  • Clicking the group displays a popover showing all the individual avatars.
Details for a group of avatars (“group” type) – live example

Responsive Behavior

Content Density

The avatar group supports the different sizes of the avatar component.

Avatar group sizes (XS, S, M, L, XL)

Overflow Button

If there is not enough space to display all the avatars in a group, an overflow button appears and one or more avatars move into the overflow popover.

The overflow displays as a shape containing a count. The count indicates how many avatars can’t be displayed on the screen. If the number is too large to fit into the shape, the shape grows to accommodate the number.

It is possible to have a custom overflow.

Avatar group overflow – live example

Globalization and Localization

The avatar group supports left-to-right (LTR) and right-to-left (RTL) reading directions.

Avatar group – left-to-right
Avatar group – right-to-left

Related Links

Components

Implementation