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

Badge

OverviewStyleGuidelinesCodeAccessibilityDemos
ImportingUsagerh-badgeImportingUsagerh-badge

Importing

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

<script type="module">
  import '@rhds/elements/rh-badge/rh-badge.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-badge number="7">7</rh-badge>
<rh-badge number="24">24</rh-badge>
<rh-badge number="240">240</rh-badge>
<rh-badge threshold="900" number="999">999</rh-badge>

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

rh-badge

A badge is used to annotate other information like a label or an object name.

  • neutral - Indicates generic information or a message with no severity.
  • danger - Indicates a danger state, like an error that is blocking a user from completing a task.
  • warning - Indicates a warning state, like a non-blocking error that might need to be fixed.
  • caution - Indicates an action or notice which should immediately draw the attention
  • info - Indicates helpful information or a message with very little to no severity.
  • success - Indicates a success state, like if a process was completed without errors.
Slots 0
None
Attributes 3
Attribute DOM Property Description Type Default
state state

Denotes the state-of-affairs this badge represents

| 'danger' | 'warning' | 'caution' | 'neutral' | 'success' | 'moderate' // deprecated | 'important' // deprecated | 'critical' // deprecated | 'info'
'neutral'
number number

Sets a numeric value for a badge.

You can pair it with threshold attribute to add a + sign if the number exceeds the threshold value.

number | undefined
unknown
threshold threshold

Sets a threshold for the numeric value and adds + sign if the numeric value exceeds the threshold value.

number | undefined
unknown
Methods 0
None
Events 0
None
CSS Shadow Parts 0
None
CSS Custom Properties 0
None
Design Tokens 13
Token Copy
--rh-border-radius-pill
Full CSS Variable Permalink to this token
--rh-color-status-caution
Full CSS Variable Permalink to this token
--rh-color-status-danger
Full CSS Variable Permalink to this token
--rh-color-status-info
Full CSS Variable Permalink to this token
--rh-color-status-neutral
Full CSS Variable Permalink to this token
--rh-color-status-success
Full CSS Variable Permalink to this token
--rh-color-status-warning
Full CSS Variable Permalink to this token
--rh-color-text-primary-on-dark
Full CSS Variable Permalink to this token
--rh-color-text-primary-on-light
Full CSS Variable Permalink to this token
--rh-font-size-body-text-xs
Full CSS Variable Permalink to this token
--rh-length-lg
Full CSS Variable Permalink to this token
--rh-line-height-body-text
Full CSS Variable Permalink to this token
--rh-space-md
Full CSS Variable Permalink to this token
© 2021-2025 Red Hat, Inc. Deploys by Netlify