ButtonGroup

Groups multiple related actions a user can take.

GuidelinesReact

When to use

If you’re unsure what component or type to use for actions, check out our interactive guide on action components.

  • To group several actions with similar purposes.
  • If the actions are important, fill the group with buttons.
  • If the actions are less important, fill the group with button links.

When not to use

  • When you have too many actions—separate them so as not to overwhelm users.
  • When the actions are more complex and have structure—use a tile group.

Component status

Figma

React

iOS

Android

N/A
Released
N/A
N/A

Content structure

Related actions: all actions within the group are visually connected; buttons: includes more important actions; ButtonLinks: includes less important actions.

Guidelines

Use only for closely related actions

Button groups remove many visual clues that there are multiple actions, such as spacing and border radiuses on buttons. This makes them great at presenting a united visual.

It also makes it more difficult for users to distinguish that there are multiple actions. So only use them for actions that clearly relate to one another.

Follow guidelines for children

Make sure to follow the guidelines for whatever components you’re using within the group, buttons or button links. See our interactive guide on choosing the right component for your actions.