Components
Avatar
An avatar is a visual element that represents a user or entity. It typically displays a user's profile picture, initials, or a generic icon to provide a quick visual identity in the interface.
When to use
User identification
To represent users in profile sections, account menus, or navigation bars.
User identification
To represent users in profile sections, account menus, or navigation bars.
User identification
To represent users in profile sections, account menus, or navigation bars.
Content attribution
To show who created a piece of content, such as next to a comment, forum post, or chat message in collaborative UI's..
Content attribution
To show who created a piece of content, such as next to a comment, forum post, or chat message in collaborative UI's..
Content attribution
To show who created a piece of content, such as next to a comment, forum post, or chat message in collaborative UI's..
Lists of people
To create a visually scannable list of users, such as in contact lists, team member directories, or permission settings.
Lists of people
To create a visually scannable list of users, such as in contact lists, team member directories, or permission settings.
Lists of people
To create a visually scannable list of users, such as in contact lists, team member directories, or permission settings.
Collaborative contexts
To indicate who is currently active on a page or to whom a document is shared.
Collaborative contexts
To indicate who is currently active on a page or to whom a document is shared.
Collaborative contexts
To indicate who is currently active on a page or to whom a document is shared.
When to avoid
As a primary action
While it can be interactive (linking to a profile), its primary purpose is identification, not action (e.g. "Save" or "Submit").
As a primary action
While it can be interactive (linking to a profile), its primary purpose is identification, not action (e.g. "Save" or "Submit").
As a primary action
While it can be interactive (linking to a profile), its primary purpose is identification, not action (e.g. "Save" or "Submit").
Where identity is not needed
Avoid using in contexts where a visual representation adds no value or creates unnecessary visual clutter, such as in dense data tables where a name is more sufficient.
Where identity is not needed
Avoid using in contexts where a visual representation adds no value or creates unnecessary visual clutter, such as in dense data tables where a name is more sufficient.
Where identity is not needed
Avoid using in contexts where a visual representation adds no value or creates unnecessary visual clutter, such as in dense data tables where a name is more sufficient.
Specifications
Style
Image
Displays a user's photograph.
Primary
Primary-colored background when no image. High contrast.
Background
A neutral background color for low contrast, secondary uses.
Ghost
A transparent background with a simple icon. Ensure it's placed on top of an accessible background.
Image
Displays a user's photograph.
Primary
Primary-colored background when no image. High contrast.
Background
A neutral background color for low contrast, secondary uses.
Ghost
A transparent background with a simple icon. Ensure it's placed on top of an accessible background.
Image
Displays a user's photograph.
Primary
Primary-colored background when no image. High contrast.
Background
A neutral background color for low contrast, secondary uses.
Ghost
A transparent background with a simple icon. Ensure it's placed on top of an accessible background.
Image
Displays a user's photograph.
Primary
Primary-colored background when no image. High contrast.
Background
A neutral background color for low contrast, secondary uses.
Ghost
A transparent background with a simple icon. Ensure it's placed on top of an accessible background.
Size
Small, Default, Large
Use the small size for more dense UI's like a list of users. Use the large option for more prominent placements like a user profile page header.
Small, Default, Large
Use the small size for more dense UI's like a list of users. Use the large option for more prominent placements like a user profile page header.
Small, Default, Large
Use the small size for more dense UI's like a list of users. Use the large option for more prominent placements like a user profile page header.
Border
True
Adds a 1px border around the avatar. Useful for creating visual separation from the background or a group of avatars.
False
The avatar has no border.
True
Adds a 1px border around the avatar. Useful for creating visual separation from the background or a group of avatars.
False
The avatar has no border.
True
Adds a 1px border around the avatar. Useful for creating visual separation from the background or a group of avatars.
False
The avatar has no border.
True
Adds a 1px border around the avatar. Useful for creating visual separation from the background or a group of avatars.
False
The avatar has no border.
Anatomy
1
Border
Use the optional white border to separate overlapping avatars in a group or to make a single avatar stand out on a busy or low-contrast background.
2
Content
For no-image avatars, designers can swap the content between text or an icon.
Value
Avatar
Avatar