Mara logo

Avatar

A small image or initials standing for a person or organisation, used to make ownership and presence scannable.

UI Components

An avatar turns “who” into something scannable. In a list of comments, assignments or activity, a recognisable face or initials is read faster than a name. The component is mostly a fallback chain: photo, then initials on a colour derived deterministically from the identifier, then a neutral placeholder. Deterministic colour matters — an avatar that changes colour between sessions stops being recognisable.

Two things routinely go wrong. Initials from a single `name` field break on mononyms, multi-part surnames and non-Latin scripts; derive them defensively and accept one character. And avatars must carry accessible names: a decorative image with an empty alt in a list of assignees leaves screen-reader users with a row of unattributed items. Use the person's name as the alt, or place it in adjacent text.

In practice

A project tool generated fallback colours from a random seed at render time. The same user appeared blue in one session and green in the next. Users reported “the wrong person is assigned”. Hashing the user id to a fixed palette entry made avatars stable and the reports stopped.

Where teams get it wrong

  • Non-deterministic fallback colours, which break recognition between sessions.
  • Initials logic that assumes two Latin-script name parts.
  • Avatars with empty alt text in lists where they carry the only identity.
  • Stacked group avatars with no overflow count and no way to see the full list.
  • Loading full-size images into 24px circles.

Learn more

You may ask

Frequently Asked Questions

What should an avatar show when there is no photo?

Initials on a background colour derived deterministically from the user id, so the same person always looks the same. Fall back to a neutral icon only when there is no usable name at all.

Do avatars need alt text?

If the avatar is the only thing identifying the person in that row, yes — use their name. If the name is already in adjacent text, the image is decorative and an empty alt avoids reading it twice.

Related terms

All terms

Defined by Mara Last reviewed .

Let's talk about your product.

Happy to look at what you're building and say where design would move the needle.

Contact Us