Getting Started
Overview
Installation
Theme
Forms
Basic Inputs
Select
Custom Inputs
Components
Navigation
Components
69
Micro Charts
Libraries
Kanban Board
Image Designer
Video Player
Visual Builder
Content Editor
Data View
Latest npm version of @ngstarter-ui/componentsWeekly npm downloads of @ngstarter-ui/components
Purchase

Avatar

The Avatar component represents a user, team, file, folder, or other entity with an image, initials, generated placeholder, or icon. Use it as a compact identity marker in tables, lists, comments, account menus, cards, and collaborator interfaces.

Use it for:
  • People and entities: Show users, teams, files, projects, or folders in a compact visual form.
  • Fallback identity: Use initials, icons, automatic colors, or DiceBear placeholders when no image is available.
  • Presence: Add online, offline, or away indicators for users and collaborators.
  • Groups: Stack multiple avatars and show hidden participants with an avatar-more item.

Do not use Avatar as a full user profile card, a standalone status label, or a decorative image. Combine it with Card, Table, Select, Autocomplete, or other components when more structure is needed.

PropTypeDefault
image
The URL of the image to display
string''
variant
The visual variant of the avatar
AvatarVariant''
label
The text label to display (initials)
string''
alt
Accessibility label for the image
string''
clickable
Whether the avatar is clickable
booleanfalse
automaticColor
HEX color for automatic background and text color generation
stringundefined
presenceIndicator
The presence status indicator
AvatarPresenceIndicatornull