Skip to Content
ComponentsInputMultiSelect

MultiSelect

Multi-value select — selected options render as removable chips. maxTagCount collapses overflow into a “+N” tag.

Tags
With overflow
import { MultiSelect } from '@gg-software/ui'; <MultiSelect label="Tags" placeholder="Select tags" options={options} value={selected} onChange={(values, options) => setSelected(values)} /> <MultiSelect label="With overflow" maxTagCount={2} options={options} />

Options use the same SelectOption shape as Select.

Props

PropTypeDefaultDescription
options*SelectOption<T>[]—
valueT[]—
defaultValueT[][]
onChange((value: T[], options: SelectOption<T>[]) => void)—
placeholderstringSelect…
labelReactNode—
hintReactNode—
errorReactNode—
requiredboolean—
size"sm" | "md" | "lg"md
status"warning" | "error"—
disabledbooleanfalse
searchablebooleanfalse
clearablebooleanfalse
filterOption((query: string, option: SelectOption<T>) => boolean)—
emptyTextReactNodeNo options
maxTagCountnumber—show at most this many tags, then a "+N" overflow tag
idstring—
namestring—
classNamestring—

* required · generated from packages/ui/src/input/MultiSelect/MultiSelect.tsx