---
title: M3 Split button
description: Material 3 Split button in Figma: a primary action joined to a menu of related actions, Filled, Tonal or Outlined, mapped to SplitButtonLayout in Compose.
group: Platforms
source: https://www.appetiteui.com/docs/m3-split-button
dateModified: 2026-11-18
---

# M3 Split button

Updated: November 18, 2026.

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.

## 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.](https://www.appetiteui.com/images/docs/m3-split-button-board.webp)

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](https://www.appetiteui.com/docs/material-3) page; for a menu without a main action, see [Context Menu](https://www.appetiteui.com/docs/context-menu).

## Properties

Three variant axes, the label and the icon.

| Property | Type | Default |
| --- | --- | --- |
| `Size` | Small \| Medium | Small |
| `Color` | Filled \| Tonal \| Outlined | Filled |
| `Open` | False \| True | False |
| `Label` | Text | Edit |
| `Icon` | Instance swap | pencil |
| `Show icon` | Boolean | true |

| Set | Variants | Size |
| --- | --- | --- |
| `M3 / Split button` | 12, Size crossed with Color and Open | Small 133 x 40, Medium 161 x 56; Outlined 2 wider |

## Dimensions

In dp.

| Part | Value |
| --- | --- |
| Height, Small | 40 |
| Height, Medium | 56 |
| Gap between the halves | 2 |
| Inner corners | 4, 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.

| Platform | Counterpart |
| --- | --- |
| Android, Compose | `SplitButtonLayout` |
| iOS, SwiftUI | `Menu` with `primaryAction`, a tap runs the action and a long press opens the menu |

The kit has no prototype interaction on Split button.
