Avatar

Display user profile images with fallback initials, badges, and grouping support.

User
JD
Avatar
AS
1import { Avatar } from "@/zeroui/components/avatars";
2
3export default function Example() {

Sizes

X
S
M
L
X
1<Avatar size="xs" fallback="XS" />
2<Avatar size="sm" fallback="SM" />
3<Avatar size="md" fallback="MD" />

Shapes

Avatar
Avatar
1<Avatar shape="circle" src="..." />
2<Avatar shape="square" src="..." />

With Badge

Avatar
Avatar
Avatar
Avatar
Australia
1<AvatarBadge src="..." showStatus badgeColor="green" />
2<AvatarBadge src="..." showStatus badgeColor="red" />
3<AvatarBadge src="..." badgeContent={<img src="flag.png" />} />

Avatar Group

User 1
User 2
User 3
+3
User 1
User 2
User 3
User 4
+2
User 1
User 2
User 3
User 4
User 5
+1
1<AvatarGroup
2 avatars={[
3 { src: "...", alt: "User 1" },

Installation

npx zeroui@latest add avatar

Props

nametypedefaultdescription
srcstringundefined-
altstring"Avatar"-
fallbackstringundefined-
size"xs" | "sm" | "md" | "lg" | "xl""md"-
shape"circle" | "square""circle"-
borderbooleanfalse-
borderColor"default" | "white" | "primary""default"-
classNamestring""-