Skip to main content

Manage your workspace

The Clerk Dashboard is your workspace for managing applications, team members, and settings.

At the top of the Clerk Dashboard, you will see a few notable features:

  • The workspace dropdown: Allows you to switch between workspaces or create a new one.
  • The application dropdown: Allows you to choose which application you want to manage or create a new one.
  • The instance dropdown: Allows you to switch between your development and production instances.
  • The <UserButton />: Allows you to manage your account and sign out.

If you need help or have feedback about the Clerk Dashboard, reach out to the support team.

Workspaces

Workspaces are a way to group applications and resources together.

When you create a Clerk account in the Clerk Dashboard, you are automatically added to a workspace called your Personal workspace. You can edit the name of this workspace, along with other settings, on the Clerk Dashboard's Settings page.

Each workspace can have a team with multiple members, each assigned a Role that determines their access levels and Permissions. See Invite and manage team members for details on adding and managing your team.

Create additional workspaces

  1. In the top-left of the Clerk Dashboard, select the workspace dropdown.
  2. Select Create workspace. A modal will open.
  3. Complete the form. Workspace slugs are unique across all instances, so common naming conventions might already be in use by another instance.
  4. Select Create workspace. The newly created workspace will be set as the active workspace.

Invite and manage team members

  1. At the top of the Clerk Dashboard, select Invite, or navigate to the Team page and select Invite user.
  2. In the Invite user form, enter the email of the user you want to invite and select the Role to assign.
  3. Select Invite.

To manage existing team members, navigate to the Team page where you can update Roles or remove members.

Transfer ownership of an application

Transferring an application between two workspaces 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.

  1. In the top-left of the Clerk Dashboard, open the workspace dropdown and select the workspace that contains the application you want to transfer.
  2. Locate and select the application to transfer.
  3. Navigate to the application's Settings page.
  4. In the Danger zone section, select Transfer ownership. A modal will open.
  5. Complete the form and select Transfer ownership. The page will redirect to the Applications page and show the transferred application.

Transfer to a workspace without billing information

An application with an existing paid Subscription can only be transferred to a workspace with active billing information. You can set up billing information on the receiving workspace without being charged.

To set up a payment method without being charged:

  1. In the top-left of the Clerk Dashboard, select the workspace dropdown.
  2. Select the workspace that you want to transfer the application to.
  3. Select the workspace dropdown again, and select Manage.
  4. In the top menu bar, select Billing, then select Upgrade to unlimited members.
  5. Add your billing information. You will not be charged immediately. Doing this just ensures billing information is added to the workspace.
  6. Once that billing information is added, you will be able to transfer your Clerk app to the receiving workspace.

Note

This is a temporary solution for this issue. Clerk is actively working to improve this process.

Cancel your plan

Your plan covers every application in the workspace. When you cancel, the workspace moves to the Hobby plan at the end of your billing cycle. Your applications keep running.

Note

To cancel an Enterprise plan, contact your Clerk account manager. If the workspace has an unpaid invoice, pay it first, since Manage plan stays disabled until you do.

  1. In the top-left of the Clerk Dashboard, open the workspace dropdown and select the workspace whose plan you want to cancel.
  2. Navigate to the Billing page.
  3. Select Manage plan. A modal will open.
  4. On the Hobby plan, select Cancel Plan.
  5. Review what happens when you cancel and select Proceed.
  6. Review the features you'll lose and select Proceed.
  7. Optionally, share why you're canceling. Then, select Cancel plan.

You keep your plan's features until the end of your billing cycle, and usage-based features keep accruing charges until then. To avoid further usage-based charges, turn off all usage-based features.

To undo the cancellation, return to the Billing page before your billing cycle ends and select your plan's Keep option, e.g., Keep Pro plan.

Delete a workspace

Deleting a workspace also deletes its applications and their users. Workspace deletion is disabled by default. To delete a workspace, contact support for assistance.

Instances

Each Clerk application can have two different instances: Development or Production. The names are self-explanatory, but you can learn more about the differences between the two in the dedicated guide.

When you create a new application, it is automatically provisioned with a Development instance. You can switch between instances or provision your Production instance by selecting the instance dropdown in the top-left of the Clerk Dashboard.

Delete your account

Warning

Deleting your account doesn't cancel your plan. Cancel your plan first.

Deleting your account also deletes the applications in any workspace where you're the only member, including their users. To keep an application, transfer it to another workspace first. Workspaces with other members keep their applications.

  1. In the top-right of the Clerk Dashboard, select your avatar, then select Manage account. A modal will open.
  2. Select Security.
  3. In the Delete account section, select Delete account and follow the prompts to confirm.

Feedback

What did you think of this content?

Last updated on