# Org Switcher

Organization selector in the sidebar of a multi-tenant control panel.

- id: `org-switcher`
- Page: https://agentic-ui-kit.com/components/org-switcher
- Live preview: https://agentic-ui-kit.com/live/component/org-switcher

## Install

```bash
agentic-ui add org-switcher
npx shadcn@4.17.0 add @agentic-ui/org-switcher
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** combobox-selection, live-search-filtering, organization-grouping, plan-badging, keyboard-navigation, create-org-dialog, slug-auto-generation, plan-selection, zero-state-handling, live-announcements, controlled-and-uncontrolled
- **Intents:** manage-collection, configure, navigate, create-edit
- **Suits domains:** saas, auth, settings, project-management, operations
- **Interaction:** combobox-select, search-filter, keyboard-navigation, create-modal, slug-auto-generation
- **Screen role:** overview
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** organization selector in the sidebar of a multi-tenant control panel, workspace selector in the top bar with an option to create a new company, switcher between a personal account and work organizations on a B2B platform, initial onboarding flow where the user creates their first organization
- **Avoid when:** single-tenant applications where there is no concept of multiple organizations or spaces, simple selectors over a small static list of fewer than 3 fixed options where a native select is enough, deep hierarchical trees of folders or directories with infinite subfolders
- **Preserve when adapting:** combobox-interaction-model, create-org-dialog-flow, wai-aria-accessibility-contracts, slug-generation-logic
- **Replace when adapting:** brand-colors, plan-tiers-and-pricing, initial-fixtures, domain-copy
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button, dialog, input, label, popover, separator
- **npm dependencies:** lucide-react
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** SaaS Backoffice (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives
