Skip to content
Material Design 3
Main Navigation
v3
v2
v1

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

English

简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

Appearance

Sidebar Navigation

Foundations

Accessibility

Overview: Principles

Overview: Assistive technology

Designing: Overview

Designing: Color contrast

Designing: Structure

Designing: Flow

Designing: Elements

Writing and text: Best practices

Writing and text: Text truncation

Writing and text: Text resizing

Building for all: User needs

Building for all: Co-design

Content design

Overview

Alt text

Global writing: Overview

Global writing: Word choice

Notifications

Style guide: UX writing best practices

Style guide: Word choice

Style guide: Grammar and punctuation

Customizing Material

Devices

Watches: Overview

Watches: Foundations

Watches: Styles

Watches: Layout

XR

Design: Overview

Design: Interaction

Design: Layout

Design: Accessibility

Components: Overview

Components: App bars

Components: Dialogs

Components: Nav bar

Components: Nav rail

Components: Toolbars

Design tokens: Overview

Design tokens: How to use tokens

Interaction

Gestures

Inputs

Selection

States: Overview

States: State layers

States: Applying states

Layout

Overview: Overview

Overview: Parts of layout

Overview: Adaptive design

Scaffold: Overview

Scaffold: Bars

Scaffold: Rails

Scaffold: Panes

Grids & spacing: Overview

Grids & spacing: Grids

Grids & spacing: Spacing

Grids & spacing: Density

Breakpoints: Overview

Breakpoints: Compact

Breakpoints: Medium

Breakpoints: Expanded

Breakpoints: Large & extra-large

Bidirectionality & RTL

Canonical examples: Overview

Canonical examples: Feed

Canonical examples: List-detail

Canonical examples: Supporting pane

Usability: Overview

Usability: Applying M3 Expressive

Material A-Z

Styles

Color

Color system: Overview

Color system: How the system works

Color roles

Color schemes

Choosing a scheme

Static: Baseline

Static: Custom brand

Dynamic: Choosing a source

Dynamic: User-generated source

Dynamic: Content-based source

Advanced: Overview

Advanced: Apply colors

Advanced: Define new colors

Advanced: Adjust existing colors

Color resources

Elevation: Overview

Elevation: Applying elevation

Elevation: Tokens

Icons: Overview

Icons: Designing icons

Icons: Applying icons

Motion

Motion physics system: How it works

Motion physics system: Specs

Easing and duration: Applying easing and duration

Easing and duration: Tokens & specs

Transitions: Transition patterns

Transitions: Applying transitions

Shape: Overview & principles

Shape: Corner radius scale

Shape: Shape morph

Spacing: Overview

Spacing: Applying spacing

Spacing: Tokens

Typography: Overview

Typography: Fonts

Typography: Type scale & tokens

Typography: Applying type

Typography: Editorial treatments

Components

App bars: Overview

App bars: Specs

App bars: Guidelines

App bars: Accessibility

Badges: Overview

Badges: Specs

Badges: Guidelines

Badges: Accessibility

Buttons

All buttons

Button groups: Overview

Button groups: Specs

Button groups: Guidelines

Button groups: Accessibility

Buttons: Overview

Buttons: Specs

Buttons: Guidelines

Buttons: Accessibility

Extended FABs: Overview

Extended FABs: Specs

Extended FABs: Guidelines

Extended FABs: Accessibility

FAB menu: Overview

FAB menu: Specs

FAB menu: Guidelines

FAB menu: Accessibility

FABs: Overview

FABs: Specs

FABs: Guidelines

FABs: Accessibility

Icon buttons: Overview

Icon buttons: Specs

Icon buttons: Guidelines

Icon buttons: Accessibility

Segmented buttons: Overview

Segmented buttons: Specs

Segmented buttons: Guidelines

Segmented buttons: Accessibility

Split button: Overview

Split button: Specs

Split button: Guidelines

Split button: Accessibility

Cards: Overview

Cards: Specs

Cards: Guidelines

Cards: Accessibility

Carousel: Overview

Carousel: Specs

Carousel: Guidelines

Carousel: Accessibility

Checkbox: Overview

Checkbox: Specs

Checkbox: Guidelines

Checkbox: Accessibility

Chips: Overview

Chips: Specs

Chips: Guidelines

Chips: Accessibility

Date & time pickers

Date pickers: Overview

Date pickers: Specs

Date pickers: Guidelines

Date pickers: Accessibility

Time pickers: Overview

Time pickers: Specs

Time pickers: Guidelines

Time pickers: Accessibility

Dialogs: Overview

Dialogs: Specs

Dialogs: Guidelines

Dialogs: Accessibility

Divider: Overview

Divider: Specs

Divider: Guidelines

Divider: Accessibility

Lists: Overview

Lists: Specs

Lists: Guidelines

Lists: Accessibility

Loading & progress

Loading indicator: Overview

Loading indicator: Specs

Loading indicator: Guidelines

Loading indicator: Accessibility

Progress indicators: Overview

Progress indicators: Specs

Progress indicators: Guidelines

Progress indicators: Accessibility

Menus: Overview

Menus: Specs

Menus: Guidelines

Menus: Accessibility

Navigation

Navigation bar: Overview

Navigation bar: Specs

Navigation bar: Guidelines

Navigation bar: Accessibility

Navigation drawer: Overview

Navigation drawer: Specs

Navigation drawer: Guidelines

Navigation drawer: Accessibility

Navigation rail: Overview

Navigation rail: Specs

Navigation rail: Guidelines

Navigation rail: Accessibility

Radio button: Overview

Radio button: Specs

Radio button: Guidelines

Radio button: Accessibility

Search: Overview

Search: Specs

Search: Guidelines

Search: Accessibility

Sheets

Bottom sheets: Overview

Bottom sheets: Specs

Bottom sheets: Guidelines

Bottom sheets: Accessibility

Side sheets: Overview

Side sheets: Specs

Side sheets: Guidelines

Side sheets: Accessibility

Sliders: Overview

Sliders: Specs

Sliders: Guidelines

Sliders: Accessibility

Snackbar: Overview

Snackbar: Specs

Snackbar: Guidelines

Snackbar: Accessibility

Switch: Overview

Switch: Specs

Switch: Guidelines

Switch: Accessibility

Tabs: Overview

Tabs: Specs

Tabs: Guidelines

Tabs: Accessibility

Text fields: Overview

Text fields: Specs

Text fields: Guidelines

Text fields: Accessibility

Toolbars: Overview

Toolbars: Specs

Toolbars: Guidelines

Toolbars: Accessibility

Tooltips: Overview

Tooltips: Specs

Tooltips: Guidelines

Tooltips: Accessibility

On this page

Button groups: Specs ​

Button groups organize buttons and add interactions between them

Variants ​

Various colors and shapes of standard and connected button groups.
  1. Standard button group
  2. Connected button group

VariantM3M3 Expressive
Standard button group--Available
Connected button groupAvailable as segmented buttonSegmented buttons help people select options, switch views, or sort elements. Note: They're deprecated in the expressive update. Use a nav rail instead.More on segmented buttonsAvailable

Configurations ​

Five sizes of button groups and two shapes of button groups.

Configurations for both variants of button groups:

  1. Extra small
  2. Small
  3. Medium
  4. Large
  5. Extra large
  6. Single-select and multi-select
  7. Round and square

CategoryConfigurationM3M3 Expressive
SizeXS, S, M, L, XL--Available
Default shapeRound, square--Available
SelectionSingle-select, multi-select, selection-requiredAvailable as segmented buttonSegmented buttons help people select options, switch views, or sort elements. Note: They're deprecated in the expressive update. Use a nav rail instead.More on segmented buttonsAvailable

Tokens & specs ​

Standard and connected button group tokens are organized by size. Select the variant and size from the token set menu. Go to the button and icon button pages to view their tokens. Learn about design tokens

Button group standard - Size - Xsmall ​

TokenValue
Button group xsmall container height32dp
Button group xsmall between space18dp

Button group standard - Size - Small ​

TokenValue
Button group small container height40dp
Button group small between space12dp

Button group standard - Size - Medium ​

TokenValue
Button group medium container height56dp
Button group medium between space8dp

Button group standard - Size - Large ​

TokenValue
Button group large container height96dp
Button group large between space8dp

Button group standard - Size - Xlarge ​

TokenValue
Button group xlarge container height136dp
Button group xlarge between space8dp

Button group connected - Size - Xsmall ​

TokenValue
Button group connected xsmall container height32dp
Button group connected xsmall space between buttons2dp
Button group connected xsmall container shapeCircular
Button group connected xsmall inner corner size8dp
Button group connected xsmall pressed inner corner size4dp
Button group connected xsmall selected inner corner size50%

Button group connected - Size - Small ​

TokenValue
Button group connected small container height40dp
Button group connected small space between buttons2dp
Button group connected small container shapeCircular
Button group connected small inner corner size8dp
Button group connected small pressed inner corner size4dp
Button group connected small selected inner corner size50%

Button group connected - Size - Medium ​

TokenValue
Button group connected medium container height56dp
Button group connected medium space between buttons2dp
Button group connected medium container shapeCircular
Button group connected medium inner corner size8dp
Button group connected medium pressed inner corner size4dp
Button group connected medium selected inner corner size50%

Button group connected - Size - Large ​

TokenValue
Button group connected large container height96dp
Button group connected large space between buttons2dp
Button group connected large container shapeCircular
Button group connected large inner corner size16dp
Button group connected large pressed inner corner size12dp
Button group connected large selected inner corner size50%

Button group connected - Size - Xlarge ​

TokenValue
Button group connected xlarge container height136dp
Button group connected xlarge space between buttons2dp
Button group connected xlarge container shapeCircular
Button group connected xlarge inner corner size20dp
Button group connected xlarge pressed inner corner size16dp
Button group connected xlarge selected inner corner size50%

Anatomy ​

Button groups are invisible containers that add padding between buttons and modify button shape. They don’t contain any buttons by default.

The container outlined on both variants of button groups.
  1. Container

Common layouts ​

Mix and match buttons and icon buttons for different scenarios.

4 common layouts of button groups.
  1. Label buttons
  2. Label buttons and icon buttons
  3. Extra small icon buttons
  4. Large icon buttons

Color ​

Button groups have no color properties. They can use the default button or toggle button color styles, like filled, tonal, and outlined. Avoid using standard icon buttons or text buttons, as they have no container treatment.

The container outlined on both variants of button groups.
  1. Filled
  2. Tonal
  3. Outlined
  4. Elevated

Selection & activation ​

Standard button groups add interaction between adjacent buttons when a button is selected or activated.

This interaction changes the width, shape, and padding of the selected or activated button, which adjusts the width of buttons directly next to it.

A selected button changes shape, and briefly changes the width of itself and adjacent buttons

Connected button groups don’t add any interaction between buttons when selected or activated.

They only affect the shape of the button being selected or activated.

A selected button changes shape without affecting adjacent buttons

States ​

Standard button group ​

When a button is pressed, standard button groups modify the width and shape of that button and adjacent buttons.

5 states of a standard button group.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed

When a toggle button is selected in a standard button group, its shape should change between square and round. The color should change according to the button specs.

5 states of a standard button group with toggle buttons.
  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed

Connected button group ​

Connected button groups have different shape changes than standard button groups. Selecting a button does not affect adjacent buttons.

5 states of a segmented button group.

Connected button group unselected states:

  1. Enabled
  2. Disabled
  3. Hovered
  4. Focused
  5. Pressed

4 states of a segmented button group with toggle buttons.

Connected button group selected states:

  1. Enabled
  2. Hovered
  3. Focused
  4. Pressed

Measurements ​

Standard button group ​

Standard groups apply padding between all buttons. The amount of padding changes based on button size to ensure a minimum accessible target size of 48dp. More details on padding: Button specs, icon button specs

Standard button group padding measurements.

Standard button group inner padding:

  1. XS: 18dp
  2. S: 12dp
  3. M: 8dp
  4. L: 8dp
  5. XL: 8dp

Connected button group ​

For all connected button groups, use 2dp padding. This provides visual consistency at scale.

Connected button group padding and corner radius measurements.

Round connected button group inner padding is 2dp at every size. The outer shape is fully round, and the inner shape remains square with the following corner sizes:

  1. XS: 4dp
  2. S: 8dp
  3. M: 8dp
  4. L: 16dp
  5. XL: 20dp

Connected button group padding and corner radius measurements for square buttons.

Square connected button group inner padding is 2dp at every size. The outer shape has the following corner sizes:

  1. XS: 4dp
  2. S: 8dp
  3. M: 8dp
  4. L: 16dp
  5. XL: 20dp

Minimum widths ​

Extra small and small connected button groups have 48dp target areas and a minimum width of 48dp.

48x48dp accessible target areas on the XS and S connected button groups.
  1. Extra small
  2. Small

Density ​

Button groups adapt to density of the buttons inside. More on density

Connected button groups at 0, -1, -2, and -3 density.
Button groups adapt to the height of the buttons inside, including when density is applied
Pager
Previous pageButton groups: Overview
Next pageButton groups: Guidelines

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google

https://m3.material.io/components/button-groups/specs

Released under the Apache 2.0 or CC BY 4.0

Copyright © 2018-Present Google