form · Normal DOM only

Combobox

Single-pick from a long or fuzzy-searchable list. cmdk-backed — keyboard nav, type-to-filter, groups.

Use when the user knows the value by name (a person, a company, a stage). For ≤ 6 fixed options use Select. For multi-pick use MultiSelect.

Install

Pull from the workspace packages (already available if you ran pnpm add):

ts
import { Combobox } from '@8maverik8/twenty-design';

Examples

Grouped picker

Two groups, one disabled option, descriptions on a single item.

tsx
<Combobox value={v} onValueChange={setV} options={[…]} />

Anatomy

options[].groupOptional grouping heading; ungrouped options render first.
options[].descriptionQuiet line under the label — useful for ids, hints, examples.
options[].disabledGreyed out, not selectable, but still searchable.

Guidelines

✓
Group options when the list is heterogeneous (Open vs Closed, Active vs Archived).A flat 30-item list feels overwhelming even with search.
✓
Use the description slot for the value's id or aliases.The keyword field already indexes them — visible hints make scanning faster.
✕
Use Combobox for two-option toggles.Use a Switch, RadioGroup or ToggleGroup instead.