Avatar

Also known as: Profile image, User icon

Preview

MD

Resources

Properties

PropertyValuesDefault
Variant ModeFill | SoftFill
Content VariantInitials | Picture | IconIcon
Size VariantXs | Sm | Md | Lg | Xl | 2XlMd
Initials TextstringDS
Icon InstanceSwapAny iconuser

Best practises

  • Use avatars to visually represent users, accounts or entities.
  • Use a recognizable image, initials or icon to represent entities.
  • Provide fallback content for the image or initials.

Variants

Variants define the visual appearance of components and communicate the priority of the action or information they represent. Some common variants are provided out of the box (see the table below), but you can also create new variants to match your system's needs.

Variants are created and managed through variable modes in the design system tokens.

VariantWhen to use
FillUsed as a primary component style to display highest priority. Visually, it has high contrast compared to its surroundings.
SoftUsed as a complimentary style, uses less contrasting fill color.