Skip to content
zedkit
@zedtech/zedkit-ui

MultiSelect

Searchable multi-select with removable chips, shared empty/loading states, keyboard support.

beta@zedtech/zedkit-ui

Wraps: downshift, @radix-ui/react-popover

Docs

1 tag(s) selected.

View props table
Who is it for?
Filters and tag pickers where several values apply.
When should I use it?
Tag filters, multi-assignee fields, facet pickers.
When should I pick something else?
For a single value — use Combobox or Select.

Use it

Simple
import { MultiSelect, type ComboboxOption } from "@zedtech/zedkit-ui";
const tags: ComboboxOption[] = [{ value: "docs", label: "Docs" }];
<MultiSelect options={tags} value={picked} onValueChange={setPicked} aria-label="Tags" />;

Kit not installed yet?

This ships on npm only; there is no copy-source brick for it.

You get
Every component from one import, with the theme tokens included. Updates arrive with your package manager.
You need
  • React 19 and Tailwind CSS 4, for example a Next.js app created with the Tailwind option.
  1. Install

    Terminal
    pnpm add @zedtech/zedkit-ui @fontsource-variable/inter @fontsource-variable/space-grotesk
  2. Load the styles

    Tailwind does not scan node_modules, so the @source line points it at the kit's class names. The path is relative to this file.

    src/app/globals.cssReplace the contents
    @import "tailwindcss";
    @import "@zedtech/zedkit-ui/styles.css";
    @source "../../node_modules/@zedtech/zedkit-ui/src/**/*.{ts,tsx}";
    @source not "../../node_modules/@zedtech/zedkit-ui/src/**/*.test.*";
    
  3. Pick a look

    Set data-identity="glass" on <html> so the finished app matches the site. Fresh app: replace src/app/layout.tsx. Existing app: merge, and keep ThemeProvider and other providers.

    src/app/layout.tsxReplace the contents
    import "./globals.css";
    import "./fonts";
    
    export default function RootLayout({ children }: { children: React.ReactNode }) {
      return (
        <html lang="en" data-identity="glass">
          <body>{children}</body>
        </html>
      );
    }
    
  4. Load the fonts

    The Glass look uses Inter and Space Grotesk; these imports self-host them.

    src/app/fonts.tsCreate the file
    import "@fontsource-variable/inter";
    import "@fontsource-variable/space-grotesk";
    
  5. Import and render

    Simple
    import { MultiSelect, type ComboboxOption } from "@zedtech/zedkit-ui";
    
    const tags: ComboboxOption[] = [{ value: "docs", label: "Docs" }];
    <MultiSelect options={tags} value={picked} onValueChange={setPicked} aria-label="Tags" />;
    

Package version 2.0.1.

Props

Prop

Type

Accessibility

Selected values appear as chips with remove buttons; listbox behaves like Combobox for adding.

Troubleshooting

Duplicate chips — the same `value` is already selected. Chips missing labels — every option needs a stable `value` and human `label`.

On this page