Controls / The visual dictionary

Button group.

Visually gathers related actions in one place.

Also calledaction groupgrouped buttons
01

See it in context

UI illustration

Grouping makes the relationship between actions easier to understand. A group can contain a primary action and alternatives or several commands that act on the same object.

When to use it

Keep related actions adjacent and preserve a sensible keyboard focus order.

Know the difference

A segmented control usually has persistent selection; a button group can contain independent actions.

WebiOSiPadOSAndroidmacOSWindowsLinux

Web

Use a native button for an action and an anchor for navigation. Preserve keyboard activation and a visible focus indicator.

iOS · iPadOS · Android

Provide a comfortable touch target, use familiar system symbols when appropriate, and show a clear pressed or selected state.

macOS · Windows · Linux

Keep pointer, keyboard, and focus behavior consistent. Common commands can additionally expose a menu item or keyboard shortcut.

Primary documentation for the pattern and its platform conventions.