Skip to main content Home
About About the Design SystemRoadmap
Get started OverviewDesignersDevelopers
Foundations OverviewColorGridIconographyInteractionsSpacingTypography
Tokens Overview Global colorbox shadowTypographyborderopacityspacelengthIconBreakpointsMedia Queries
Elements All elements Accordion Alert Announcement Audio player Avatar Back to top Badge Blockquote Breadcrumb Button Card Chip Code block Call to action Dialog Disclosure Footer Health index Icon Jump links Navigation (primary) Navigation (secondary) Pagination PopoverPlanned Progress stepsPlanned Site status Skip link Spinner Statistic Subnavigation Surface Switch Table Tabs Tag Tile Timestamp Tooltip Video embed
Theming OverviewColor PalettesCustomizingDevelopers
Patterns All PatternsCardTabsFilterFormLink with iconLogo wallSearch barSticky bannerSticky cardTile
Personalization All Personalization PatternsAnnouncement
Accessibility FundamentalsAccessibility toolsAssistive technologiesCI/CDContentContributorsDesignDevelopmentManual testingResourcesScreen readers
Design/code status Release notes Get support

Icon

OverviewStyleGuidelinesCodeAccessibilityDemos
OverviewStatusWhen to useIcons and setsStatus checklistOverviewStatusWhen to useIcons and setsStatus checklist

Overview

Icons represents general concepts and can support text as a decorative element. The icon element is a container that allows users to add icons of varying dimensions in the same area without shifting surrounding content.

import "@rhds/elements/rh-icon/rh-icon.js";
<rh-icon icon="hat"></rh-icon>

Icon set

Icon name

Defines a string value that labels the icon element. Adds role="img" to element.

Controls how eager the element will be to load the icon data

  • eager: eagerly load the icon, blocking the main thread
  • idle: wait for the browser to attain an idle state before loading
  • lazy (default): wait for the element to enter the viewport before loading

Status

When to use

  • When you want to supplement the meaning of text with a visual element
  • When you need to represent a UI function with an approved Red Hat icon
  • When you need an icon to occupy a certain amount of space

Icons and sets

<rh-icon> exclusively uses the official Red Hat brand icons.

Browse the icon sets

Image of three icons

Status checklist

© 2025 Red Hat Deploys by Netlify