Prologue

Contribution Guide Release Notes Upgrade Guide

Getting Started

Introduction Installation Client Side Routing Colors

Dark Mode

Inertia.js Next.js Vite

Buttons

Button File Trigger Toggle Group Toggle

Collections

Choicebox Dropdown Grid List List Box Menu Table Tag Group Tree

Colors

Color Area Color Field Color Picker Color Slider Color Swatch Picker Color Swatch Color Thumb Color Wheel

Controls

Command Menu Context Menu Keyboard Slider Switch Toolbar

Date And Time

Calendarupdated Date Field Date Picker Date Range Picker Range Calendarupdated Time Field

Drag And Drop

Drop Zone

Forms

Checkbox Group Checkbox Field Form Input Otp Number Field Radio Group Search Field Tag Field Text Field Textarea

Layouts

Container Navbar Sidebar

Media

Avatar Carousel

Navigation

Breadcrumbs Disclosure Group Disclosure Link Pagination Tabs

Overlays

Dialog Drawer Modal Popover Sheet Tooltip

Pickers

Combo Box Multiple Select Select

Statuses

Badgeupdated Loader Meter Noteupdated Progress Bar Progress Circle Skeleton Toastupdated

Surfaces

Card Description List Heading Separator Show More

Utilities

Visually Hidden

Visualizations

Area Chart Bar Chart Bar List Chart Line Chart Pie Chart Tracker

Pickers

Multiple Select

A flexible dropdown input that enables users to select multiple options, ideal for tagging, categorization, and filtering tasks.

Basic

The basic multiple select component lets you select multiple options from a list. It displays selected options with Tag components.

Installation

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.

This component comes packed with several components to enhance functionality and provide a seamless experience.

field list box popover tag group visually hidden

Manual installation

npm i react-aria-components react-aria @intentui/icons

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"
  items={fruits}
>
  {(item) => {
    return (
      <MultipleSelect.Item textValue={item.name}>
        {item.name}
      </MultipleSelect.Item>
    )
  }}
</MultipleSelect>

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.

Select tags

Food

Music

You have selected: 24

Max items

You can limit the number of selected items using the maxItems prop.

Select tags

Invalid

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

Disabled

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

Fruits

Props

Here's the fixed table:

Prop	Type	Default	Description
label	string	-	The label of the multiple select
description	string	-	The description of the multiple select
placeholder	string	-	The placeholder of the multiple select
className	string	-	The class name of the multiple select
name	string	-	The name of the multiple select
items	array of objects	-	The list of multiple select items (options)
selectedKeys	Selection	-	The selected keys of the multiple select
onSelectionChange	function	-	The callback function for selection
maxItems	number	-	The max number of items that can be selected
isDisabled	boolean	-	The disabled state of the multiple select
isInvalid	boolean	-	The invalid state of the multiple select
errorMessage	string	-	The error message if invalid