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

Tag

OverviewStyleGuidelinesCodeAccessibilityDemos
ImportingUsagerh-tagImportingUsagerh-tag

Importing

Add rh-tag to your page with this import statement:

<script type="module">
  import '@rhds/elements/rh-tag/rh-tag.js';
</script>
Copy to Clipboard Wrap lines

To learn more about installing RHDS elements on your site using an import map read our getting started docs.

Usage

<rh-tag>Tag</rh-tag>

<script type="module">
  import '@rhds/elements/rh-tag/rh-tag.js';
</script>
Copy to Clipboard Wrap lines

rh-tag

A tag is a caption added to an element for better clarity and user convenience.

Slots 2
Slot Name Summary Description

Must contain the text for the label.

icon

Contains the labels's icon, e.g. web-icon-alert-success.

Attributes 6
Attribute DOM Property Description Type Default
icon icon

The icon to display in the label.

IconNameFor<IconSetName>
unknown
icon-set iconSet

Icon set to display in the label

IconSetName
'ui'
variant variant

The variant of the label.

'filled' | 'outline' | 'desaturated'
'filled'
size size

The variant of the label.

'compact'
unknown
href href

optional href for linked tag.

string
unknown
color color

The color of the label. Note: 'cyan' will also work, but is deprecated

| 'red' | 'red-orange' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'purple' | 'gray'
unknown
Methods 0
None
Events 1
Event Name Description
close

when a removable label's close button is clicked

CSS Shadow Parts 1
Part Name Summary Description
icon

container for the label icon

CSS Custom Properties 9
CSS Property Description Default
--rh-tag-margin-inline-end 4px
--rh-tag-padding-block-start 4px
--rh-tag-padding-block-end 4px
--rh-tag-padding-inline-start 8px
--rh-tag-padding-inline-end 8px
--rh-tag-padding-block-start 0
--rh-tag-padding-inline-end var(--rh-space-md, 8px)
--rh-tag-padding-block-end 0
--rh-tag-padding-inline-start var(--rh-space-md, 8px)
Design Tokens 70
Token Copy
--rh-space-xs
Full CSS Variable Permalink to this token
--rh-font-family-body-text
Full CSS Variable Permalink to this token
--rh-font-weight-body-text-regular
Full CSS Variable Permalink to this token
--rh-font-size-body-text-sm
Full CSS Variable Permalink to this token
--rh-line-height-body-text
Full CSS Variable Permalink to this token
--rh-color-surface-lighter
Full CSS Variable Permalink to this token
--rh-size-icon-01
Full CSS Variable Permalink to this token
--rh-border-radius-pill
Full CSS Variable Permalink to this token
--rh-border-width-sm
Full CSS Variable Permalink to this token
--rh-color-border-subtle
Full CSS Variable Permalink to this token
--rh-border-width-md
Full CSS Variable Permalink to this token
--rh-font-size-body-text-xs
Full CSS Variable Permalink to this token
--rh-space-md
Full CSS Variable Permalink to this token
--rh-color-red-50
Full CSS Variable Permalink to this token
--rh-color-red-70
Full CSS Variable Permalink to this token
--rh-color-red-10
Full CSS Variable Permalink to this token
--rh-color-red-20
Full CSS Variable Permalink to this token
--rh-color-red-60
Full CSS Variable Permalink to this token
--rh-color-red-30
Full CSS Variable Permalink to this token
--rh-color-red-orange-50
Full CSS Variable Permalink to this token
--rh-color-red-orange-70
Full CSS Variable Permalink to this token
--rh-color-red-orange-10
Full CSS Variable Permalink to this token
--rh-color-red-orange-20
Full CSS Variable Permalink to this token
--rh-color-red-orange-60
Full CSS Variable Permalink to this token
--rh-color-red-orange-30
Full CSS Variable Permalink to this token
--rh-color-orange-50
Full CSS Variable Permalink to this token
--rh-color-orange-70
Full CSS Variable Permalink to this token
--rh-color-orange-10
Full CSS Variable Permalink to this token
--rh-color-orange-20
Full CSS Variable Permalink to this token
--rh-color-orange-60
Full CSS Variable Permalink to this token
--rh-color-orange-30
Full CSS Variable Permalink to this token
--rh-color-yellow-50
Full CSS Variable Permalink to this token
--rh-color-yellow-70
Full CSS Variable Permalink to this token
--rh-color-yellow-10
Full CSS Variable Permalink to this token
--rh-color-yellow-20
Full CSS Variable Permalink to this token
--rh-color-yellow-60
Full CSS Variable Permalink to this token
--rh-color-yellow-30
Full CSS Variable Permalink to this token
--rh-color-green-50
Full CSS Variable Permalink to this token
--rh-color-green-70
Full CSS Variable Permalink to this token
--rh-color-green-10
Full CSS Variable Permalink to this token
--rh-color-green-20
Full CSS Variable Permalink to this token
--rh-color-green-60
Full CSS Variable Permalink to this token
--rh-color-green-30
Full CSS Variable Permalink to this token
--rh-color-teal-50
Full CSS Variable Permalink to this token
--rh-color-teal-70
Full CSS Variable Permalink to this token
--rh-color-teal-10
Full CSS Variable Permalink to this token
--rh-color-teal-20
Full CSS Variable Permalink to this token
--rh-color-teal-60
Full CSS Variable Permalink to this token
--rh-color-teal-30
Full CSS Variable Permalink to this token
--rh-color-blue-50
Full CSS Variable Permalink to this token
--rh-color-blue-70
Full CSS Variable Permalink to this token
--rh-color-blue-10
Full CSS Variable Permalink to this token
--rh-color-blue-20
Full CSS Variable Permalink to this token
--rh-color-blue-60
Full CSS Variable Permalink to this token
--rh-color-blue-30
Full CSS Variable Permalink to this token
--rh-color-purple-50
Full CSS Variable Permalink to this token
--rh-color-purple-70
Full CSS Variable Permalink to this token
--rh-color-purple-10
Full CSS Variable Permalink to this token
--rh-color-purple-20
Full CSS Variable Permalink to this token
--rh-color-purple-60
Full CSS Variable Permalink to this token
--rh-color-purple-30
Full CSS Variable Permalink to this token
--rh-color-gray-70
Full CSS Variable Permalink to this token
--rh-color-gray-10
Full CSS Variable Permalink to this token
--rh-color-gray-20
Full CSS Variable Permalink to this token
--rh-color-gray-60
Full CSS Variable Permalink to this token
--rh-color-white
Full CSS Variable Permalink to this token
--rh-color-gray-95
Full CSS Variable Permalink to this token
--rh-color-gray-30
Full CSS Variable Permalink to this token
--rh-color-gray-50
Full CSS Variable Permalink to this token
--rh-color-text-primary
Full CSS Variable Permalink to this token
© 2025 Red Hat Deploys by Netlify