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

Button group

OverviewStyleGuidelinesCodeAccessibilityDemos
StyleColor schemeSpaceInteraction statesStyleColor schemeSpaceInteraction states

Style

A button group is two or more Buttons grouped together. A button group can include buttons and icon buttons.

Anatomy

Anatomy of a button group showing different combinations of buttons.
  1. Primary and Secondary buttons
  2. Secondary, Primary, and Link buttons
  3. Icon buttons
  4. Scheme toggle with icon buttons

Orientation

Button groups are available in both horizontal and vertical orientations.

Diagram showing horizontal and vertical button group orientations.

Color scheme

Button groups are available in both light and dark color schemes.

Light scheme

Button groups in a light color scheme.

Dark scheme

Button groups in a dark color scheme.

Space

When button groups are vertical, there is less padding.

Button spacing between Primary and Secondary buttons, Primary and Link buttons, and between icon buttons is 16px horizontally and 8px vertically; Link buttons separated from other buttons use 48px horizontally and 32px vertically.

Interaction states

Refer to the Button or Scheme toggle pages for interaction states.

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