Sections

• Introduction
• Installation
• Styling
• Colors
• Forms
• Skills
• RTL
• LLMs.txt
• Changelog

Components

• Accordion
• Action Bar
• Alert Dialog
• Alert
• Announcement
• Aspect Ratio
• Autocomplete
• Avatar
• Badge
• Bottom Navigation
• Breadcrumb
• Button Group
• Button
• Calendar
• Card
• Carousel
• Chart
• Checkbox
• Circular Progress
• Circular Slider
• Clipboard
• Collapsible
• Color Picker
• Combobox
• Command
• Context Menu
• Data List
• Date InputNew
• Date Picker
• Dialog
• DrawerUpdated
• Editable
• Field
• File Upload
• FloatUpdated
• Floating Panel
• Frame
• Hint
• Hover Card
• Image Cropper
• Input Group
• Input OTP
• Input
• Item
• Kbd
• Link Overlay
• Listbox
• Marquee
• Menu
• Native Select
• Number Input
• Pagination
• Password Input
• Popover
• Progress
• Prose
• QR Code
• Radio Group
• Rating
• Resizable
• Scroll Area
• Segment Group
• Select
• Separator
• Sheet
• Sidebar
• Signature Pad
• Skeleton
• Skip Nav
• Slider
• Spinner
• StatusUpdated
• Steps
• Switch
• Table
• Tabs
• Tags Input
• Textarea
• Timer
• Toast
• Toggle Group
• Toggle Tooltip
• Toggle
• Tooltip
• Tour
• Tree View

Utilities

• Client Only
• Download Trigger
• Format
• Highlight
• Hitbox
• JSON Tree View
• Presence
• Show
• Swap

Forms

• Formisch
• React Hook Form
• TanStack Form

Hooks

• useIsMobile

Avatar

Copy Markdown

Displays a user's profile image with fallback.

DocsAPI

PreviewCode

VV

CN

VV

SA

PV

+2

Installation#

CLIManual

pnpmbunnpmyarn

pnpm dlx shadcn@latest add @shark/avatar

Anatomy#

Avatar
├── AvatarImage
└── AvatarFallback

AvatarGroup
├── AvatarGroupCount
└── Avatar
    ├── AvatarImage
    ├── AvatarFallback
    └── AvatarBadge

Usage#

import { 
  Avatar, 
  AvatarImage, 
  AvatarFallback 
} from "@/components/ui/avatar";

<Avatar>
  <AvatarImage src="https://github.com/vinihvc.png" />
  <AvatarFallback>VV</AvatarFallback>
</Avatar>

Sizes#

Small#

PreviewCode

VV

Medium#

PreviewCode

VV

Large#

PreviewCode

VV

Examples#

Avatar Group#

PreviewCode

VV

SA

PV

IA

Badge#

PreviewCode

VV

SA

PV

Badge with Icon#

PreviewCode

VV

Fallback with Icon#

PreviewCode

Avatar Group Count#

PreviewCode

VV

SA

PV

IA

+5

Avatar Group Count Icon#

PreviewCode

VV

SA

PV

IA

Avatar with Popover#

PreviewCode

VV

SA

PV

IA +5

Avatar with Hover Card#

PreviewCode

VV

CN

Custom Size#

Use size-* to set the size of the avatar.

PreviewCode

VV

You can use breakpoint utilities to change the size at different screen sizes.

md:size-4 lg:size-8

Custom Radius#

Use rounded-* to set the radius of the avatar.

PreviewCode

VV

CN

SA

PV

You can use breakpoint utilities to change the radius at different screen sizes.

md:rounded-full lg:rounded-lg

API Reference#

Avatar#

Container for user or entity profile image. Supports sizes and fallback.

AvatarImage#

Profile image. Shown when URL loads; fallback used on error.

AvatarFallback#

Shown when the image fails to load or is loading. Often initials or icon.

AvatarGroup#

Groups avatars with overlap and optional count badge.

AvatarGroupCount#

Shows "+N" when more avatars exist than displayed.

AvatarBadge#

Status or indicator badge overlaid on the avatar corner.

For a complete list of props, see the Ark UI documentation.

[

Previous page

Autocomplete ](/docs/components/autocomplete)[

Next page

Badge ](/docs/components/badge)

On This Page

InstallationAnatomyUsageSizesSmallMediumLargeExamplesAvatar GroupBadgeBadge with IconFallback with IconAvatar Group CountAvatar Group Count IconAvatar with PopoverAvatar with Hover CardCustom SizeCustom RadiusAPI ReferenceAvatarAvatarImageAvatarFallbackAvatarGroupAvatarGroupCountAvatarBadge