Skip to main content Home About the Design SystemRoadmap OverviewDesignersDevelopers OverviewColorGridIconographyInteractionsSpacingTypography Overview Global colorBox shadowTypographyBorderOpacitySpaceLengthIconBreakpointsMedia queries All elements Accordion Alert Announcement Audio player Avatar Back to top Badge Blockquote Breadcrumb Button group Button Card Chip Code block Call to action Dialog Disclosure Footer Health index Icon Jump links Menu dropdown Navigation link Navigation (primary) Navigation (secondary) Navigation (vertical) Pagination PopoverPlanned Progress stepper Scheme toggle Site status Skeleton Skip link Spinner Statistic Subnavigation Surface Switch Table Tabs Tag Tile Timestamp Tooltip Video embed OverviewColor PalettesCustomizingDevelopers All PatternsAccordionCall to ActionCardFilterFormLink with iconLogo wallSearch barSticky bannerSticky cardTabsTagTile All Personalization PatternsAnnouncement FundamentalsAccessibility toolsAssistive technologiesCI/CDContentContributorsDesignDevelopmentManual testingResourcesScreen readers Design/code status Release notes Get support

Avatar

OverviewStyleGuidelinesCodeAccessibilityDemos
OverviewStatusWhen to useStatus checklistOverviewStatusWhen to useStatus checklist

Overview

Provides a small thumbnail representation of a user, including image and optional title and subtitle. Use when representing a specific person by image, name, and/or job title.

rh-avatar::part(img) {
  object-position: top;
}
 
import '@rhds/elements/rh-avatar/rh-avatar.js';
 
<rh-avatar name="Omar Khayyam" subtitle="Mathematician, Astronomer" src="khayyam.jpg"></rh-avatar>
 
import { Avatar } from "@rhds/elements/react/rh-avatar/rh-avatar.js";

// NOTE: React 19+ does not require these wrapper imports.
// You can use the custom elements directly as-is.

export const Demo = () => (
  <Avatar name="Omar Khayyam" subtitle="Mathematician, Astronomer" src="khayyam.jpg" />
);

The URL to the user's custom avatar image.

It will be displayed instead of a random pattern.

The user's name, either given name and family name, or username.

When displaying a pattern, the name will be used to seed the pattern generator. When `plain` is set, the name and subtitle are used as accessible labels

Auxiliary information about the user. May be used to add job title, company, etc. When `plain` is set, the name and subtitle are used as accessible labels

Places avatar on the left or on top of the text.

The type of pattern to display.

When true, hides the title and subtitle

Adds a subtle border to the avatar image

Status

When to use

  • When you need to represent a user who has not provided a photo or image

Status checklist

Edit this page on GitHub
© 2026 Red Hat Deploys by Netlify