Skip to main content

Components

Avatar

Avatar displays an image, initials, or icon for a person, entity, or profile.

We are working to improve the accessibility documentation for this component. If you have questions or see something that should be prioritised, please contact us on Github or Slack.

How to describe Avatar for screen readers

Avatar must either have an aria-label that describes who or what the avatar represents, or be set to aria-hidden with visible text conveying the same information. Do not state in the aria-label that it is an image - screen readers announce this automatically. It is sufficient to use the name, for example aria-label="Ola Nordmann".

Images and other children are automatically given aria-hidden="true" to prevent information from being repeated.

Edit this page on github.com (opens in a new tab)