> ## 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.

# Segmented control

> Segmented controls allow users to switch between different views, categories, or content filters in real time, without leaving the current page or context. They’re typically used for mutually exclusive options, where selecting one option deselects the others.

## Segmented control

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

### When to use

* To toggle between related views or data sets, like switching between "List view" and "Grid view".
* To filter content by category, such as “All”, “Private”, “Public”.
* When you want to provide quick, mutually exclusive choices that immediately affect the display without navigating away.
* When the options are closely related and equal in hierarchy.
* For primary view switches.

### When to use something else

* Options need longer descriptions or aren’t a tight filter set: use [Radio](/aura-design-system/primitives/radio).
* Larger content sections or page-scale switching: use [Tabs](/aura-design-system/primitives/tabs).
* Binary on/off: use [Switch](/aura-design-system/primitives/switch).
* Mutually exclusive **actions** (not views): use [Toolbar](/aura-design-system/primitives/toolbar) or [Toggle group](/aura-design-system/primitives/toggle-group) as appropriate.
* More than \~five options or multi-select: use [Select](/aura-design-system/primitives/select), [Combobox](/aura-design-system/primitives/combobox), or [Tree view](/aura-design-system/primitives/tree-view).

### Dos and don'ts

* Do pre-select a default option that is most common or aligns with the primary task.
* Do be consistent in icon and label usage. If using a leading icon for one control, use them for all.
* Do keep the options between 2-5 so as not to overwhelm the user.
* Don't use Segmented control for unrelated actions.
* Don't mix icon-only with label-only.
* Don't use Segmented control to trigger actions like "Save" or "Delete".

### Often used with

* The content region it toggles (e.g. list vs grid); [Tooltip](/aura-design-system/primitives/tooltip) if any segment is icon-only.