Combobox

A searchable select, in single or multi mode, for option lists too long to scan.

Country

Combobox or Select?

Select is right when the whole list fits on screen and is worth reading. Once someone would rather type three letters than scan, or once they need more than one answer, use this.

Multi-select

Markets

Sizes

Loading, disabled, error

loading is for options still in flight: the panel keeps its shape instead of flashing an empty list.

Pick at least one market.

Controlled

Markets

2 selected

Props

Prop	Type	Default	Description
options	ComboboxOption[]		{ value, label, icon?, disabled? } for each entry.
mode	'single' \| 'multi'	'single'	Multi keeps the panel open and accumulates chips.
size	'sm' \| 'md' \| 'lg'	'md'	Control height.
label	string		Field label.
description	string		Helper line under the field.
error	string		Error message; switches the field to its error styling.
placeholder	string		Placeholder for the search input.
loading	boolean	false	Shows the panel's loading state while options are being fetched.
value	string \| string[]		Controlled selection. An array in multi mode.
onChange	(value: string \| string[]) => void		Fires with the new selection.
disabled	boolean	false	Disables the control.

PreviousSelect NextCheckbox