Skip to main content Home
About About the Design SystemRoadmap
Get started OverviewDesignersDevelopers
Foundations OverviewColorGridIconographySpacingTypography
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 PatternsCardTabsFilterFormLinkLink with iconLogo wallSearch barSkip navigationSticky bannerSticky cardTileVideo thumbnail
Personalization All Personalization PatternsAnnouncement
Accessibility FundamentalsAccessibility toolsAssistive technologiesCI/CDContentContributorsDesignDevelopmentManual testingResourcesScreen readers
Design/code status Release notes Get support

Icon

OverviewStyleGuidelinesCodeAccessibilityDemos
Labelling iconsHiding iconsARIA Authoring Practices Guide (APG)Web Content Accessibility GuidelinesLabelling iconsHiding iconsARIA Authoring Practices Guide (APG)Web Content Accessibility Guidelines

Labelling icons

If an icon is interactive or otherwise not merely decorative, it will need to be labeled using the accessible-label property, which will apply aria-label and role="img" automatically.

Image of a download icon, an arrow pointing down with an underline beneath it

However, when an icon is accompanied by text, the icon does not need to use accessible-label.

Image of a download icon with text, an arrow pointing down with an underline beneath it with accompanying download text

Learn more about using icons in interactive elements

Hiding icons

An <rh-icon> is hidden from assistive technology by default. If an icon is presentational, there’s no need to change the markup to hide the icon.

Icons will be hidden from assistive technology by default

There is no need to add the additional aria-hidden="true"

ARIA Authoring Practices Guide (APG)

Learn to use the accessibility semantics defined by the Accessible Rich Internet Application (ARIA) specification to create accessible web experiences.

View APG resources

Web Content Accessibility Guidelines

Understanding documents provide detailed explanations for Web Content Accessibility Guidelines (WCAG) guidelines and success criteria.

© 2021-2025 Red Hat, Inc. Deploys by Netlify