Avatar

Free + Pro

An image element with a fallback for representing the user. Pro version includes status indicators, badges, animations, and group features.

Unlock Advanced Avatar Features

Get access to powerful pro features that enhance your avatar component with advanced capabilities, premium styling options, and optimized performance.

  • Status indicators (online, offline, busy, away, focus)
  • Notification badges with icons and counters
  • Animated gradient rings and effects

Pro Features

Unlock advanced capabilities with the Pro version

Status Indicators

Real-time status indicators with customizable positions and colors

Badge Notifications

Notification badges with content, icons, and custom variants

Animations

Built-in animations including pulse, bounce, spin, and ping effects

Gradient Rings

Animated gradient rings with customizable colors and glow effects

Advanced Shapes

Multiple shape options including circle, square, and hexagon

Group Components

Advanced avatar groups with spacing controls and overflow handling

Installation

Install via CLI

moonui add avatar

Usage

Basic Usage

Pro Required
CN

Pro Usage

PRO
Pro Required
CN
LT
5

Examples

Basic Usage

Avatar with image and fallback text.

CNJD

Sizes

Different avatar sizes for various use cases.

XSSMMDLGXL2XL

Variants

Different visual styles for avatars.

DFRGROBD

Shapes

Different border radius options.

SQSMLGFL

With Icons

Custom fallback content with icons.

Avatar Group

Display multiple avatars with overlap.

All Avatars

JD
JS
BJ
AW
MK

With Limit (3)

JD
JS
BJ
+2

Custom Overlap

JD
JS
BJ
AW
+1

Status Indicators

Avatars with status indicators.

ON
AW
BS
OF
PRO
Pro Examples

Pro Avatar with Status

PRO

Advanced avatar with status indicators and animations.

Pro Required
ON

Online

AW

Away

FC

Focus

Badge Notifications

PRO

Avatars with notification badges and icons.

Pro Required
5

Gradient Rings

PRO

Avatars with animated gradient rings.

Pro Required
PR

Advanced Avatar Group

PRO

Pro avatar group with advanced overlapping and animations.

Pro Required

Team Members (Tight)

A
B
C
D
E
+3

Contributors (With Status)

A
B
C
D

Async Avatar Loading

PRO

Avatars with loading and error states.

Pro Required

Loading...

Error

Loaded

Different Shapes

PRO

Pro avatars with hexagon and other custom shapes.

Pro Required
CI

Circle

SQ

Square

HX

Hexagon