Create and manage organizations
You can create organizations in the Clerk Dashboard, or end users can create them in your application. Once created, you can manage individual organization profiles, and update settings. Clerk provides components to help users switch between multiple organizations.
This guide covers working with individual organizations. For global settings that affect all organizations in your application (like enabling organizations, setting default roles, or configuring membership), refer to Configure Organizations.
Create an organization
You can create organizations in the Clerk Dashboard, or end users can create them in your application. The number of organizations you can create depends on your Monthly Active Organization (MAO) limits.
Create an organization in the Clerk Dashboard
To create an organization in the Clerk Dashboard:
- In the Clerk Dashboard, select Organizations.
- Select the Create Organization button.
- Enter the organization's name. Optionally, upload the organization's logo, enter the organization's slug, and select the organization's owner. The slug is a unique identifier for the organization that you can use in URLs, such as
example-name.
Create an organization in your application
By default, users have permission to create organizations within your application. When a user creates an organization, they become the organization's admin with full control over settings, members, and permissions.
Default limits: Each user can create up to 100 organizations. To change creation permissions or limits, see the Configure Organizations guide.
The easiest way to allow users to create organizations is to use the <CreateOrganization /> and/or <OrganizationSwitcher /> components. The <OrganizationSwitcher /> component is more comprehensive, as it handles all organization flows including creation, switching, and management.
If the prebuilt components don't meet your needs, you can build custom flows using the Clerk API.
Manage organizations
As an application owner, you can manage all organizations in your application. This includes the organizations you created and those created by your users. You can view, update, and delete organizations, as well as manage their members and settings.
Manage organizations in the Clerk Dashboard
To manage organizations in the Clerk Dashboard:
- In the Clerk Dashboard, select Organizations to view all organizations in your application.
- Select a specific organization to view its details, members, invitations, and settings.
- From here, you can update the organization's name, slug, logo, and public and private metadata. You can also adjust the organization's membership limit.
Manage organizations in your application
For managing organizations in your application, Clerk provides prebuilt components that handle organization management flows:
- <OrganizationProfile /> - A profile page for the user's currently active organization where they can update settings and manage members.
- <OrganizationSwitcher /> - A dropdown menu that handles all organization flows, including switching between organizations and managing the active organization's profile.
- <OrganizationList /> - A list of organizations that a user is a member of, with options to switch between them.
If the prebuilt components don't meet your needs, you can build custom flows using the Clerk API.
Switch between organizations
Users who belong to multiple organizations can switch between them at any time. The currently selected organization is called the active organization.
The <OrganizationSwitcher /> component provides the easiest way for users to switch between organizations. If you need more control over the switching logic, you can use the setActive() method from the useOrganizationList() hook, or access it directly from the Clerk object.
If personal accounts are enabled, users can also switch to their personal account using the <OrganizationSwitcher /> component.
Next steps
Now that you know how to create and manage organizations, you can:
Feedback
Last updated on