# Avatar

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Display a person or team avatar with image, text, and gradient fallbacks for lists, comments, and member details.

We are building SnowUI components into interfaces people can use directly in AI conversations. Conversational UI is still in development; this page demonstrates website usage. Supported chat platforms and component versions will be announced after verification. Generating and using SnowUI interfaces inside AI conversations is completely free. It is not a project, uses no project or developer-seat quota, and requires no SnowUI registration, activation, or paid proof.

Package: `@snowui-design-system/components`. Import: `import { Avatar } from '@snowui-design-system/components';`. Source fingerprint: `626124a24208b9029e76de37c74927cd94307ffced6d2ebf22da71a16fdcb7ba`.

## Usage choices

Use Avatar for a user or team identity. Use AvatarGroup for overlapping participants; compose Avatar with an ordinary list and text for a vertical contact list.

- Show an image with src and configure fallback or fallbackText for missing images. Provide a stable fallbackSeed for the same identity.
- Use as="badge" for a corner badge or as="avatar-image" to replace the visual. Explicit size takes priority, followed by parent avatar size.

## Read as needed

- [API](https://snowui.dev/llms/en/components/avatar/api.md): Public Props and defaults
- [Types and states](https://snowui.dev/llms/en/components/avatar/types.md): Public type declarations and binding rules
- [Full reference](https://snowui.dev/llms/en/components/avatar/reference.md): Composition and interaction boundaries
- [Styles](https://snowui.dev/llms/en/components/avatar/styles.md): Registered public overrides
- [Examples](https://snowui.dev/llms/en/components/avatar/examples.md): Code and preview links
- [Image index](https://snowui.dev/llms/components/avatar/images.json): Use only if appearance remains uncertain
- [Changelog](https://snowui.dev/llms/en/components/avatar/changelog.md): Version history reviewed in English

[Design guide](https://snowui.dev/llms/en/design-system.md) · [Styling guide](https://snowui.dev/llms/en/styling.md)