Black Friday · Save 40% on Intent UI Design licenses with code UI2026.

Multiple Select

Loading...

Installation

Add the component with the CLI.

npx shadcn@latest add @intentui/multiple-select

Composed components

When you install this component via the CLI, it automatically loads all composed components, so you don’t need to add them individually.

Manual installation

Install the dependencies, then copy the component source into your project.

npm install react-aria-components react-aria @heroicons/react

Anatomy

import { MultipleSelect, MultipleSelectItem, MultipleSelectLabel, MultipleSelectSection } from "@/components/ui/multiple-select"
<MultipleSelect
  className="min-w-2xs max-w-min"
  placeholder="Select fruits"
  aria-label="Fruits"
>
  <MultipleSelectContent items={fruits}>
    {(item) => {
      return (
        <MultipleSelectItem textValue={item.name}>
          {item.name}
        </MultipleSelectItem>
      )
    }}
  </MultipleSelectContent>
</MultipleSelect>

Examples

Controlled

This component lets you select tags dynamically, updating the list with callbacks on add and remove. It displays selected tags with Tag components and logs each action.

Loading...

Invalid

When the component is invalid, it displays an error message.

Loading...

Disabled

When the component is disabled, it prevents the user from adding or removing tags.

Loading...

Component API

MultipleSelect

MultipleSelect extends the React Aria Components <Select> component.

classNamestring
namestring
onSearchChange(value: string) => void
placeholderstring
Default: No selected items
searchPlaceholderstring
searchValuestring

MultipleSelectContent

MultipleSelectContent is a custom declarative slot and does not extend a DOM or React Aria component.

itemsIterable<T>

MultipleSelectItem

MultipleSelectItem extends the Intent UI <ListBoxItem> component.

classNamestring

See the React Aria for the full API reference.

Design