Org Switcher

A control for switching between organisations within the app shell.

$bunx shadcn@latest add @nx-ui/org-switcher
Registry item
Installs withavatardropdown-menuutils
Used byscope-breadcrumbsuser-menu

Primary usage

A dropdown trigger showing the active organisation's avatar, name and role, with every organisation listed beneath — the active one gets a tick. Selecting an item updates the trigger.

With logo images

When an org has a logoUrl, it renders in the square avatar instead of the name's initials.

Without 'Create organisation'

onCreateOrg is optional — omit it to drop the separator and create action, e.g. for members who can't provision new organisations.

In a sidebar

The switcher is designed to sit at the top of the nx app-shell sidebar, above the nav sections.

Sites & plotsBatchesWaste intake

API reference

Exported parts and their props, extracted from the component source.