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

# Combobox

> A searchable select input that filters a list of options as the user types. Supports single and multi-select, and optionally allows users to add new items that aren't in the existing list.

## Combobox

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

### When to use

* More than \~12 options, where typing to filter is faster than scrolling.
* The user knows roughly what they're looking for (e.g. selecting a country, an asset name, a tag).
* Forms where users need to search and select from a predefined list.
* When users need to add new options that don't exist in the list yet.

### When to use something else

* Fewer than \~12 options: use [Select](/aura-design-system/primitives/select), [Radio](/aura-design-system/primitives/radio), or [Checkbox](/aura-design-system/primitives/checkbox) depending on context.
* The user is unfamiliar with the available options and wouldn't know what to type: a visible list is less intimidating.
* Very large datasets where filtering may cause lag: consider a [Data grid](/aura-design-system/primitives/data-grid) with toolbar filtering instead.
* Free text input with no list to select from: use [Input](/aura-design-system/primitives/input) or [Textarea](/aura-design-system/primitives/textarea).

### Dos and don'ts

* Do group related options if the list spans multiple categories.
* Don't use it for simple yes/no or small option sets: the search affordance implies more options than are there.

### Behavior

* Single-select: the menu closes immediately on selection.
* Multi-select: the menu stays open until the user clicks outside, presses Escape, or presses Enter.

### Combobox menu

Combobox 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 on the left side of the menu item. Badges should be placed on the right side of the menu item.

### Often used with

* [Label](/aura-design-system/primitives/label), [Helper text](/aura-design-system/primitives/helper-text); optional [Badge](/aura-design-system/primitives/badge) on menu rows; same field anatomy as [Input](/aura-design-system/primitives/input) (leading/trailing slots) when used in forms.