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 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

Tag

OverviewStyleGuidelinesCodeAccessibilityDemos
OverviewStatusWhen to useStatus checklistOverviewStatusWhen to useStatus checklist

Overview

A tag provides a short, pill-shaped label for categorizing content or indicating status. It should include an icon when color alone conveys meaning. Linked tags must have descriptive text for screen readers, and should provide an aria-label on group containers. When disabled, Enter keyboard navigation is suppressed on linked tags.

import '@rhds/elements/rh-tag/rh-tag.js';
 
<rh-tag>Tag</rh-tag>
 
import { Tag } from "@rhds/elements/react/rh-tag/rh-tag.js";

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

export const Demo = () => (
  <Tag>Tag</Tag>
);

The name of the icon to display in the tag. When set, an rh-icon element renders in the icon slot as a decorative visual.

The icon set from which to select the icon. Defaults to ui.

The visual style variant of the tag.

  • filled: colored background with a subtle border (default)
  • outline: transparent background with a colored border
  • desaturated: transparent background with a neutral border and text color

The size of the tag. When set to compact, the tag uses a smaller font size and reduced padding.

Optional URL that makes the tag a navigable link. When set, the tag renders an anchor element around its text content.

Whether an interactive (linked) tag is disabled. When true, the tag visually appears inactive and keyboard navigation is suppressed.

The color palette of the tag. Nine colors are available. Choose colors that correspond to the tag's semantic meaning (e.g. red for errors, green for success). Defaults to gray.

Note: cyan is accepted but deprecated; use teal instead.

 View source on GitHub

Status

When to use

  • Categorize content
  • Add context or clarity to elements
  • Indicate status

Status checklist

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