Version 1.0.0

Avatar

An avatar is a thumbnail representation of an entity, such as a user or an organization.

Options#


The avatar size scale, starting at the smallest size of avatar-size-50 and ending at the largest size of avatar-size-700.

Size#

Avatar sizes scale exponentially, based on the Spectrum type scale. These range from size-50 to size-700. An avatar can also be customized to fit appropriately for your context.

Examples of three avatars, each one using a photograph of different people's faces.

Image#

Avatars can have a defined image, which is usually uploaded by a user.

Example of an avatar in a disabled state, in grey and unable to be interacted with.

Disabled#

An avatar in a disabled state shows that an avatar exists, but is not available or a user is not active in that circumstance. This can be used to maintain layout continuity and communicate that an avatar may become available or active later.

Table of options#

From the design point of view, each component has a number of options. These options and their names are platform agnostic, and each implementation should adapt these to fit into their framework.

PropertyValuesDefault Value
size
50 / 75 / 100 / 200 / 300 / 400 / 500 / 600 / 700 / custom
100
image
image / nothing
is disabled
yes / no
no

Behaviors#


Example of an avatar showing a photograph of a woman's face, in keyboard focus state. There is a blue ring around the avatar.

Keyboard focus#

An avatar can be navigated using a keyboard. The keyboard focus state adds a blue ring to the avatar in focus.

Usage guidelines#


Use generic avatars when image is undefined#

Use branded generic avatars when a user has not set their avatar image. These images are designed to be abstracted from all genders, locales, and cultures.

Key example of how to design generic avatars. Four avatars showing images of abstract shapes, in blue, purple, green, and yellow.
Key example of how to not to design generic avatars. Two gendered silhouettes, one of a man's profile and one of a woman's profile.

Don’t make assumptions and use gendered placeholder avatars.

Changelog#


DateNumberNotes
Apr 05, 20202.0.0
  • Updated size options
  • Added image option
  • Added disabled option
  • Added keyboard focus state
Feb 04, 20201.0.0
  • This component has been added to the website

Design checklist#


All interactive states

Includes all interactive states that are applicable (hover, down, focus, keyboard focus, disabled).

Multiple options

Includes relevant options (variant, style, size, orientation, optional iconography, decorations, selection, error state, etc.)

All color themes

Works properly across all four color themes (lightest, light, dark, darkest).

All platform scales

Includes a desktop scale (UWP, macOS, web desktop) and a mobile scale (iOS, Android, web mobile).

Defined behaviors

Includes guidelines for layout (wrapping, truncation, overflow), animation, interactions, etc.

Usage guidelines

Includes a list of dos and don’ts that highlight best practices and common mistakes.

Accessible contrast

Follows WCAG 2.0 standards for contrast (AA).

Internationalization guidelines

Works properly across various locales and includes guidelines for bi-directionality (RTL).

Keyboard interactions

Follows WCAG 2.0 standards for keyboard accessibility guidelines and includes a description of the keyboard interactions.

Design tokens

All design attributes (color, typography, layout, animation, etc.) are included in Spectrum DNA.

Generated UI kit

Includes a downloadable XD file that has been generated by code and shows multiple variations, states, color themes, and scales.

In Spectrum for Adobe XD plugin

Component is included in the Spectrum for Adobe XD plugin.