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
maxTagCountnumbershow at most this many tags, then a "+N" overflow tag
idstring
namestring
classNamestring

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