# Form Tree Select

Tree select dropdown for nested categories with checkboxes and indeterminate parents.

- id: `form-tree-select`
- Page: https://agentic-ui-kit.com/components/form-tree-select
- Live preview: https://agentic-ui-kit.com/live/component/form-tree-select?piece=form-tree-select

## Install

```bash
agentic-ui add form-tree-select
npx shadcn@4.17.0 add @agentic-ui/form-tree-select
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** hierarchical-select, single-select, multi-select, indeterminate-parents, search-with-ancestors, lazy-children, wai-aria-tree, roving-tabindex, popover, form-field, dark-mode
- **Intents:** create-edit, manage-collection, configure
- **Suits domains:** ecommerce, saas, knowledge, file-storage, crm, operations
- **Interaction:** click, search, keyboard-navigation, expand-collapse, popover
- **Screen role:** management
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** tree select dropdown for nested categories with checkboxes and indeterminate parents, hierarchical multi-select with search that opens the matching branches, choose a folder or category from a tree and load child nodes on demand, single select from a nested list of departments
- **Avoid when:** a flat list of options (use a select or form-async-combobox), a table that shows tree rows with columns (use table-tree-hierarchy), ordering the chosen items matters (use form-transfer-list)
- **Preserve when adapting:** tree-semantics, tri-state-parents, lazy-contract
- **Replace when adapting:** nodes, loader, summary-text
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** popover
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives