> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Toggle group

> A set of mutually exclusive options where one or multiple can be selected. Use it for toggling on settings, such as grid lines, rulers, or text formatting options like bold, italics, underline, etc.

## Toggle group

<Badge color="blue">v1.0.0</Badge> | [View in Storybook](https://master--695bb4b1b8041ae09768950a.chromatic.com/?path=/docs/primitives-toggle--docs)

### When to use

* 2–4 options that are mutually exclusive and always visible.
* The current selection needs to be immediately obvious.

### When to use something else

* More than \~4–5 options: use [Select](/aura-design-system/primitives/select) or [Menu](/aura-design-system/primitives/menu).
* Options fire one-off commands: use [Button](/aura-design-system/primitives/button) or grouped buttons, not a [Toggle group](/aura-design-system/primitives/toggle-group).
* Multi-select filters: use [Checkbox](/aura-design-system/primitives/checkbox) or filter chips ([Badge](/aura-design-system/primitives/badge) / closeable patterns).
* Single-select filter of a small set: use [Segmented control](/aura-design-system/primitives/segmented-control).
* Page navigation: use [Tabs](/aura-design-system/primitives/tabs) or routing, not [Toggle group](/aura-design-system/primitives/toggle-group).

### Dos and don'ts

* Do keep labels short — one or two words per option or use icons only.
* Don't mix icons and text labels across options in the same group — be consistent.

### Behavior

* Selection updates immediately; supports single or multi-select per configuration. Do not use for destructive one-shot actions without confirmation.

### Often used with

* [Toolbar](/aura-design-system/primitives/toolbar) formatting tools; [Tooltip](/aura-design-system/primitives/tooltip) when icon-only; mutually exclusive or multi-select state next to the canvas or preview it affects.