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

# Select

> Select allows users to choose one or more pre-defined options from a list. It’s typically used in forms or filtering contexts where predefined options are available.

## Select

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

### When to use

* When there are multiple predefined options, and the user needs to select one or more.
* When space is limited and you don’t want to display all the options at once.
* When the options are familiar to the user and do not require additional explanation.
* For form inputs that require a specific selection.

### When to use something else

* More than \~12 options or search helps: use [Combobox](/aura-design-system/primitives/combobox).
* Very few options or binary on/off: use [Checkbox](/aura-design-system/primitives/checkbox), [Radio](/aura-design-system/primitives/radio), or [Switch](/aura-design-system/primitives/switch).
* User-defined or creatable values: use [Combobox](/aura-design-system/primitives/combobox).
* Options need long descriptions visible at once: use [Checkbox](/aura-design-system/primitives/checkbox) or [Radio](/aura-design-system/primitives/radio).
* Selection immediately runs an action (not form field value): use [Button](/aura-design-system/primitives/button), [Toggle group](/aura-design-system/primitives/toggle-group), or [Toolbar](/aura-design-system/primitives/toolbar).
* Page-level view switching: use [Segmented control](/aura-design-system/primitives/segmented-control) or [Tabs](/aura-design-system/primitives/tabs).

### Dos and don'ts

* Do provide a clear label and placeholder copy. Use help text if clarification is needed.
* Do be careful with using default selections as users may not thoroughly check the default.
* Do group related options in the list if there are multiple categories. List in order of frequency or alphabetically - whichever is better suited for the task.

### Select menu

Select menus display a checkmark, or toggle, to the right of the menu item, instead of on the left like traditional Context and Dropdown menus. This is because scanning the list is easier when the checkmark is on the right. Therefore it is recommended to avoid leading content like an icon or [Badge](/aura-design-system/primitives/badge) on the left side of the menu item. Badges should be placed on the right side of the menu item.

### Behavior

* Single-select: choosing an item commits the value and closes the list (unless design specifies otherwise).
* Multi-select: list may stay open until dismissed; confirm patterns (Apply) belong in [Select panel](/aura-design-system/primitives/select-panel)-style flows.

### Often used with

* [Label](/aura-design-system/primitives/label), [Helper text](/aura-design-system/primitives/helper-text); [Badge](/aura-design-system/primitives/badge) on items when needed; trigger is often a [Button](/aura-design-system/primitives/button)-styled field.