---
title: Organization Switcher Widget
description: A widget for switching between organizations in your application.
originalPath: .tmp-workos-clone/packages/docs/content/widgets/organization-switcher.mdx
---

The `<OrganizationSwitcher />` widget allows users to switch between organizations. There are no special permissions required to use this widget as users can switch between organizations they have access to. If an organization requires SSO or MFA, the user will be redirected to reauthorize with the new organization.

![Organization Switcher screenshot](https://images.workoscdn.com/images/e22cad7a-f11a-4f47-8cc7-fb015a22114f.png?auto=format&fit=clip&q=80)

### Switching Organizations

There are multiple ways to integrate with the Organization Switcher widget depending on your library choice. If you are using either the `authkit-js` or `authkit-react` libraries, you can use the `useAuth` hook to get the current organization and pass it to the widget.

<CodeBlock>
  <CodeBlockTab
    language="js"
    file="widget-organization-switcher-authkit-react"
    title="React Library"
  />
</CodeBlock>

If you are using one of the backend SDKs, you can build the organization switcher action in the backend and pass it in as a prop to the widget to be called when the user attempts to switch organizations. See the [Switching Organizations](/authkit/sessions/integrating-sessions/switching-organizations) guide for more information to set up the backend actions. This can then be passed in as a prop to the widget.

<CodeBlock>
  <CodeBlockTab
    language="js"
    file="widget-organization-switcher-backend"
    title="Backend Handling"
  />
</CodeBlock>

### Creating Organizations

The widget accepts children components that can be used to either redirect the user to create an organization or to show a modal with a form to create an organization. You can use this to integrate with your existing organization creation flow that uses the WorkOS APIs to create organizations.

<CodeBlock>
  <CodeBlockTab
    language="js"
    file="widget-organization-switcher-create-authkit-react"
    title="Create Organization"
  />
</CodeBlock>

## API Reference

<PropsTable data={widgets.organizationSwitcher.props} />