
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.