All components

INPUTS / COMPONENTS

Multi-select

Find and choose several options.

Live component11 documented props

About multi-select

Multi Select is a dynamic select component with autocomplete. This component can be used for simple or complex sorting.

01

Anatomy

Shared parts, named consistently.

  1. 1
    Multi Select DropdownDropdownRequired

    A dropdown to open the list.

  2. 2
    Multi Select DropdownLabelRequired

    The label of the dropdown.

  3. 3
    Multi Select DropdownAsterix

    A star to show when required.

  4. 4
    Multi Select DropdownSelected options textRequired

    A text string to show the number of options selected.

  5. 5
    Multi Select DropdownIconRequired

    An icon to show if opened or closed.

  6. 6
    Multi Select DropdownHelper message

    A string below the input to provide additional context about the Dropdown. When in an error state, the helper message will turn red.

  7. 1
    Multi Select ListboxDropdown ListboxRequired

    The container of the modal.

  8. 2
    Multi Select ListboxText FieldRequired

    An input to search for items.

  9. 3
    Multi Select ListboxFilter PillRequired

    A selectable pill to show what items are checked.

  10. 4
    Multi Select ListboxMore options countRequired

    A count to show how many options are hidden.

  11. 5
    Multi Select ListboxButtonRequired

    Icon to indicate if the modal is opened or closed.

  12. 6
    Multi Select ListboxHeaderRequired

    The header of the modal

Try the default

A working example with the shared V1 visual language.

Included foundationsChoose the foundations your team needs.

When to use

Use for longer lists with multiple choices. Show selection counts, support searching, and keep removal reversible.

Enter opens. Tab reaches search, native checkboxes, Clear, and Done. Space toggles a choice; Escape closes.

Related components

Source & adaptation

V1 semantic colors, DM Sans typography, compact controls, and responsive layouts. The API table describes this implementation; source design notes may use earlier API terminology.

components/library/inputs.tsx