Skip to content

M3 Button group

Button group is a row of related buttons that reads as one control. It is part of the Material 3 mirror and maps to ButtonGroup in Compose.

On this page
  1. Preview
  2. Standard or Connected
  3. Properties
  4. Dimensions
  5. Compose and iOS
  6. Get the file

Preview

Two types in two sizes. Standard spaces tonal buttons apart; Connected joins segments into one control.

Material 3 Button group in four variants. Top row, Standard: Reply, Forward and Archive as separate light blue tonal pill buttons with icons, small then medium. Bottom row, Connected: Day, Week and Month joined into one bar, Day selected in dark blue with a check and fully round, small then medium.

Source: M3 / Button group on the Material 3 Button page of the Appetite UI Figma file, read on November 18, 2026.

When is a Button group Standard and when is it Connected?

Standard for actions on the same object. Connected for one choice between views, in place of the older segmented button.

Button group types, type, use it for, how it looks
TypeUse it forHow it looks
StandardActions on the same object: Reply, Forward, ArchiveTonal buttons, 12 apart at Small and 8 at Medium
ConnectedOne choice between views: Day, Week, MonthSegments 2 apart with 8 inner corners and fully round outer corners; the selected segment turns Secondary and fully round

Rename the segments with Segment 1 to 3. The single buttons are on the Material 3 page, and the kit's own choice control is Segmented Control.

Properties

Two variant axes and three segment labels.

Properties, property, type, default
PropertyTypeDefault
TypeStandard, ConnectedStandard
SizeSmall, MediumSmall
Segment 1TextDay
Segment 2TextWeek
Segment 3TextMonth
Properties, set, variants, size
SetVariantsSize
M3 / Button group4, Type crossed with SizeStandard 353 x 48 and 424 x 56; Connected 345 x 40 and 345 x 56

Dimensions

The gaps and corners that tell the two types apart, in dp.

Dimensions, part, value
PartValue
Standard gap, Small12
Standard gap, Medium8
Connected gap2
Connected inner corners8
Connected outer cornersFully round

What does Button group map to in Compose and on iOS?

ButtonGroup in Jetpack Compose. On iOS the closest control for the Connected type is a segmented picker.

Button group in code, platform, counterpart
PlatformCounterpart
Android, ComposeButtonGroup
iOS, SwiftUIPicker with .segmented style for a Connected choice; separate buttons for Standard

The prototype shows the hover state on each segment in 200 ms.

See M3 Button group in the kit.

The read-only Figma preview opens the Appetite UI file on M3 Button group, so you can check it before you buy.

The file holds 592 variables in 6 collections and exports its token values to SwiftUI, Jetpack Compose, Flutter and CSS. Solo covers one person and Team up to ten people. You pay once and keep lifetime updates.