# Filter Menu

> A "Filter" menu for lists and tables: search for a field, open it to tick values with status icons, avatars, priority bars and counts, and keep picking without the menu closing. Each level has its own search, fields show how many values are on, and ActiveFilters renders "Status is any of" chips you can remove. Base UI Menu filtering and keyboard support.

- Slug: `filter-menu`
- Category: [Menus](https://www.assembli.design/category/menus.md)
- Type: component
- Tags: filter, dropdown, search, checkbox, submenu, table-toolbar
- npm dependencies: @base-ui/react, lucide-react
- shadcn/ui dependencies: none
- Added: 2026-10-22
- Live preview: https://www.assembli.design/preview/filter-menu
- Page: https://www.assembli.design/components/filter-menu

## Install

One-time setup (needs a subscription):

1. Add the registry to the project's `components.json`: `{"@assembli":{"url":"https://www.assembli.design/r/{name}.json","headers":{"Authorization":"Bearer ${ASSEMBLI_API_KEY}"}}}` (merge into `"registries"`).
2. Put an API key from https://www.assembli.design/account in `.env.local` as `ASSEMBLI_API_KEY=asm_…`.

Then install with the shadcn CLI (writes `components/filter-menu/filter-menu.tsx` and installs dependencies):

```bash
npx shadcn@latest add @assembli/filter-menu
```

Registry item JSON: https://www.assembli.design/r/filter-menu.json (send `Authorization: Bearer <api key>`)

## Code

> Component source needs an Assembli subscription ($12/month) and an API key sent as `Authorization: Bearer <key>`. To get one without copying anything, POST https://www.assembli.design/api/agent/login (or call the MCP tool connect_account), show the user the link it returns, and poll https://www.assembli.design/api/agent/token for the key. Or subscribe at https://www.assembli.design/pricing and create a key at https://www.assembli.design/account.