Organization workspaces in the Clerk Dashboard
In the Clerk Dashboard, there are two types of workspaces:
- Personal account: A personal account/workspace is a user's unique, individual space, independent of any organization.
- Organization workspace: An organization workspace is owned and managed by an organization, which can have multiple members, also known as collaborators. The organization workspace that a user is currently viewing is called the active organization.
This guide will walk you through how to use the Clerk Dashboard to create an organization workspace, invite collaborators, and transfer your apps between workspaces.
Create an organization workspace
- In the top-left of the Clerk Dashboard, select the workspace dropdown.
- Select Create organization. A modal will open.
- Complete the form. Organization slugs are unique across all instances, so common naming conventions might already be in use by another instance.
- Select Create organization. The newly created organization will be set the active organization.
Invite collaborators to your organization workspace
- In the top-left of the Clerk Dashboard, select the workspace dropdown.
- Select Manage. A modal will open showing the organization's information.
- In the left nav, select Members.
- Select Invite.
- In the Invite new members form, enter the email of the user you want to invite and select the role to assign.
- Select Send invitations.
Transfer ownership of an application
Transferring an application between a personal workspace and an organization, or between two organizations, does not cause disruptions. Your API keys, settings, domains, and other configurations remain unchanged, and your app will continue to function as expected. Only the ownership is updated, so no further action is needed to maintain continuity for existing users.
- In the top-left of the Clerk Dashboard, open the workspace dropdown and select the workspace that contains the application you want to transfer.
- Locate and select the application to transfer.
- At the top of the Clerk Dashboard, select Configure.
- In the navigation sidenav, under the Application heading, select Settings.
- Select Transfer ownership. A modal will open.
- Complete the form and select Transfer ownership. The page will redirect to the Applications page and show the transferred application.
Transfer to an org without billing information
An application with an existing paid subscription can only be transferred to an organization with active billing information. You can set up billing information on the receiving organization without being charged.
To set up a payment method without being charged:
- In the top-left of the Clerk Dashboard, select the workspace dropdown.
- Select the workspace that you want to transfer the application to.
- Select the workspace dropdown again, and select Manage.
- In the sidenav, select Billing, then select Upgrade to unlimited members.
- Add your billing information. You will not be charged immediately. Doing this just ensures billing information is added to the organization.
- Once that billing information is added, you will be able to transfer your Clerk app to the receiving organization.
Feedback
Last updated on