| Do | Group buttons that perform related actions on the same object, like copy, cut, paste on selected text. |
| Do | Use the same variant for all buttons in a group so they look like a single connected unit. |
| Do | Keep groups small (2–4 buttons). For more actions, use a Toolbar or DropdownMenu instead. |
| Don't | Don't mix wildly different actions. A Save button next to a Delete button in the same group is confusing. |
| Don't | Don't use ButtonGroup for navigation. Use SegmentedControl or TabList for switching between views. |
| Don't | Don't nest ButtonGroups. If you need multiple groups, place them side by side with a gap. |