Button groups: Specs
Button groups organize buttons and add interactions between them
Variants

- Standard button group
- Connected button group
| Variant | M3 | M3 Expressive |
|---|---|---|
| Standard button group | -- | Available |
| Connected button group | Available 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 buttons | Available |
Configurations

Configurations for both variants of button groups:
- Extra small
- Small
- Medium
- Large
- Extra large
- Single-select and multi-select
- Round and square
| Category | Configuration | M3 | M3 Expressive |
|---|---|---|---|
| Size | XS, S, M, L, XL | -- | Available |
| Default shape | Round, square | -- | Available |
| Selection | Single-select, multi-select, selection-required | Available 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 buttons | Available |
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
| Token | Value |
|---|---|
| Button group xsmall container height | 32dp |
| Button group xsmall between space | 18dp |
Button group standard - Size - Small
| Token | Value |
|---|---|
| Button group small container height | 40dp |
| Button group small between space | 12dp |
Button group standard - Size - Medium
| Token | Value |
|---|---|
| Button group medium container height | 56dp |
| Button group medium between space | 8dp |
Button group standard - Size - Large
| Token | Value |
|---|---|
| Button group large container height | 96dp |
| Button group large between space | 8dp |
Button group standard - Size - Xlarge
| Token | Value |
|---|---|
| Button group xlarge container height | 136dp |
| Button group xlarge between space | 8dp |
Button group connected - Size - Xsmall
| Token | Value |
|---|---|
| Button group connected xsmall container height | 32dp |
| Button group connected xsmall space between buttons | 2dp |
| Button group connected xsmall container shape | Circular |
| Button group connected xsmall inner corner size | 8dp |
| Button group connected xsmall pressed inner corner size | 4dp |
| Button group connected xsmall selected inner corner size | 50% |
Button group connected - Size - Small
| Token | Value |
|---|---|
| Button group connected small container height | 40dp |
| Button group connected small space between buttons | 2dp |
| Button group connected small container shape | Circular |
| Button group connected small inner corner size | 8dp |
| Button group connected small pressed inner corner size | 4dp |
| Button group connected small selected inner corner size | 50% |
Button group connected - Size - Medium
| Token | Value |
|---|---|
| Button group connected medium container height | 56dp |
| Button group connected medium space between buttons | 2dp |
| Button group connected medium container shape | Circular |
| Button group connected medium inner corner size | 8dp |
| Button group connected medium pressed inner corner size | 4dp |
| Button group connected medium selected inner corner size | 50% |
Button group connected - Size - Large
| Token | Value |
|---|---|
| Button group connected large container height | 96dp |
| Button group connected large space between buttons | 2dp |
| Button group connected large container shape | Circular |
| Button group connected large inner corner size | 16dp |
| Button group connected large pressed inner corner size | 12dp |
| Button group connected large selected inner corner size | 50% |
Button group connected - Size - Xlarge
| Token | Value |
|---|---|
| Button group connected xlarge container height | 136dp |
| Button group connected xlarge space between buttons | 2dp |
| Button group connected xlarge container shape | Circular |
| Button group connected xlarge inner corner size | 20dp |
| Button group connected xlarge pressed inner corner size | 16dp |
| Button group connected xlarge selected inner corner size | 50% |
Anatomy
Button groups are invisible containers that add padding between buttons and modify button shape. They don’t contain any buttons by default.

- Container
Common layouts
Mix and match buttons and icon buttons for different scenarios.

- Label buttons
- Label buttons and icon buttons
- Extra small icon buttons
- 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.

- Filled
- Tonal
- Outlined
- 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.
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.
States
Standard button group
When a button is pressed, standard button groups modify the width and shape of that button and adjacent buttons.

- Enabled
- Disabled
- Hovered
- Focused
- 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.

- Enabled
- Disabled
- Hovered
- Focused
- Pressed
Connected button group
Connected button groups have different shape changes than standard button groups. Selecting a button does not affect adjacent buttons.

Connected button group unselected states:
- Enabled
- Disabled
- Hovered
- Focused
- Pressed

Connected button group selected states:
- Enabled
- Hovered
- Focused
- 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 inner padding:
- XS: 18dp
- S: 12dp
- M: 8dp
- L: 8dp
- XL: 8dp
Connected button group
For all connected button groups, use 2dp padding. This provides visual consistency at scale.

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:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp

Square connected button group inner padding is 2dp at every size. The outer shape has the following corner sizes:
- XS: 4dp
- S: 8dp
- M: 8dp
- L: 16dp
- XL: 20dp
Minimum widths
Extra small and small connected button groups have 48dp target areas and a minimum width of 48dp.

- Extra small
- Small
Density
Button groups adapt to density of the buttons inside. More on density
