Skip to content

M3 Split button

Split button joins a primary action to a menu of related actions, such as Edit with Duplicate and Move. It is part of the Material 3 mirror.

On this page
  1. Preview
  2. When to use it
  3. Properties
  4. Dimensions
  5. Compose and iOS
  6. Get the file

Preview

Three colors, two sizes, closed and open. Open rounds the trailing half and flips the chevron.

Material 3 Split button grid. Columns are Filled in solid blue, Tonal in light blue and Outlined with a grey outline. Each shows a leading half with a pencil icon and Edit, and a trailing half with a chevron. Rows alternate closed, chevron down, and open, where the trailing half becomes a circle with the chevron up, in Small then Medium.

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

When do you use a Split button?

When one action is the usual choice and a few related ones sit behind it. Filled for the main action of a screen, Tonal for a secondary one, Outlined for a quiet one.

The leading half runs the action, the trailing half opens the menu. Set Open=True while the menu shows. For a single action, use a plain button from the Material 3 page; for a menu without a main action, see Context Menu.

Properties

Three variant axes, the label and the icon.

Properties, property, type, default
PropertyTypeDefault
SizeSmall, MediumSmall
ColorFilled, Tonal, OutlinedFilled
OpenFalse, TrueFalse
LabelTextEdit
IconInstance swappencil
Show iconBooleantrue
Properties, set, variants, size
SetVariantsSize
M3 / Split button12, Size crossed with Color and OpenSmall 133 x 40, Medium 161 x 56; Outlined 2 wider

Dimensions

In dp.

Dimensions, part, value
PartValue
Height, Small40
Height, Medium56
Gap between the halves2
Inner corners4, fully round on the trailing half when open

What does Split button map to in Compose and on iOS?

SplitButtonLayout in Jetpack Compose. On iOS the same idea is a menu with a primary action.

Split button in code, platform, counterpart
PlatformCounterpart
Android, ComposeSplitButtonLayout
iOS, SwiftUIMenu with primaryAction, a tap runs the action and a long press opens the menu

The kit has no prototype interaction on Split button.

See M3 Split button in the kit.

The read-only Figma preview opens the Appetite UI file on M3 Split button, 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.