Skip to main contentCarbon Design System

Radio button

Color

ClassPropertyColor token
.bx--labeltext color$text-secondary
.bx--radio-button__labeltext color$text-primary
.bx--radio-button__appearanceborder$icon-primary
.bx--radio-button__appearancebackground-color$background
.bx--radio-button__appearance:checkedborder$icon-primary
.bx--radio-button__appearance::beforedot$icon-primary

Interactive colors

ClassPropertyColor token
.bx--radio-button__appearance:focusborder$focus
.bx--label:disabledtext color$text-disabled
.bx--radio-button__label:disabledtext color$text-disabled
.bx--radio-button__appearance:disabledborder$icon-disabled

Typography

Radio button labels should be set in sentence case, with only the first word in a phrase and any proper nouns capitalized.

ElementFont-size (px/rem)Font-weightType token
Group label12 / 0.75Regular / 400$label-01
Radio button label14 / 0.875Regular / 400$body-compact-01

Structure

ClassPropertypx / remSpacing token
.bx--radio-button__appearanceheight, width20 / 1.25–
.bx--radio-button__appearance:beforeheight, width8 / 0.5–
.bx--radio-button__labelmargin-bottom8 / 0.5$spacing-03
.bx--radio-button__appearancemargin-right8 / 0.5$spacing-03
.bx--radio-button__appearancemargin-bottom8 / 0.5$spacing-03
Structure and spacing measurements for a radio button

Structure and spacing measurements for radio button | px | rem

The following specs are not built into the radio button component but are recommended by design as the proper amount of space around a grouping of or in between stacked radio buttons.

ClassPropertypx / remSpacing token
Horizontal alignmentmargin-right16 / 1$spacing-05
Vertical alignmentmargin-bottom8 / 0.5$spacing-03
Structure and spacing measurements for a radio button

Structure and spacing measurements for radio button | px | rem