Skip to main contentCarbon Design System

Content switcher


Content switchers have two main states: selected and unselected. By default, content switcher buttons are unselected with the selected state using a high contrast color.

ClassPropertyColor token
.bx--content-switcher-btntext color$text-02
--selectedtext color$inverse-01

Interactive states

Hover states only apply to unselected buttons.

StatePropertyColor token
:hovertext color$text-01
:disabledtext color$disabled-02
Example of content switcher states


Content switcher text should be set in sentence case, with only the first word in a phrase and any proper nouns capitalized. The text should not exceed three words.

ClassFont-size (px/rem)Font-weightType style
.bx--content-switcher-btn14 / 0.875Regular / 400$body-short-01


Content switchers must have at least two options for the user to choose from. Each container that makes up the content switcher is equal in size. The width of a container is determined by the length of the longest container option text plus the 16 px / 1rem on both sides of the text.

ClassPropertypx / remSpacing token
.bx--content-switcherheight: default40 / 2.5
.bx--content-switcherheight: small32 / 2
.bx--content-switcherheight: large48 / 3
.bx--content-switchercorner radius4px
.bx--content-switcher-btnpadding-left, padding-right16 / 1$spacing-05
Content switcher structure and spacing measurements

Structure and spacing measurements for the default size content switcher | px / rem