Difference between shared and personal workspaces.
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
This article extends What is a workspace? For Projects, please visit Create a Project and Project Settings.
Solution
Personal Workspaces (Legacy)
Prior to February 2023, when a user signed up for a Bitbucket Cloud account, Bitbucket would automatically create a workspace for the user.This workspace automatically created by Bitbucket (and not manually by the user) is called a personal workspace.
Starting February 2023 it's no longer possible to create personal workspaces for new users signed up in Bitbucket Cloud.
By default, the ID of a personal workspace is the same as the associated user's username. It is possible to change the workspace's ID to something different, but it can always be changed back to be the same as the previous username.
Workspace SSH keys and Custom merge checks are not supported for personal workspaces. If you are a workspace admin, you will not find these settings in a personal workspace's Settings.
An annual billing plan cannot be purchased for a personal workspace. However, a monthly Free, Standard, or Premium plan is possible.
Additional admins can be added to a personal workspace, however, they will not have access to the Apps and features section in the workspace's Settings. This section can only be accessed by the user associated with the personal workspace.
If a repository transfer request is sent TO a personal workspace, then only the user associated with the workspace will be sent an email about accepting the transfer request. Additional workspace admins will not be sent this email.
To transition to a team workspace you will need to update both the username and workspaceID to something else so that these are free for usage on the new workspace.
Shared/Team Workspaces
As of February 2023, this is the only type of workspace that can be created. Any workspace created manually by a user is considered a shared workspace.
The workspace ID of a shared workspace must be unique across our platform. It can't be the same as the ID of an existing workspace or as a Bitbucket user's username.
Workspace SSH keys and Custom merge checks are available for shared workspaces.
A shared workspace can be on a monthly Free, Standard, or Premium plan. An annual Premium plan can also be purchased for a shared workspace, as long as the workspace is newly created.
Additional admins can be added to a shared workspace. All admins have access to all the workspace's Settings.
If a repository transfer request is sent TO a shared workspace, then all workspace admins will be sent an email about accepting the transfer request.
If you are encountering issues following this documentation - please raise a support ticket or a community support ticket for further assistance.
Is my workspace personal or shared?
If you created this workspace manually yourself, then it is a shared workspace.
If you are a workspace admin, find this:
Open the workspace on Bitbucket's website.
Select the cog icon > Workspace settings.
Look for the section with the title Security. If you see the option SSH keys under this section, then the workspace is shared. If you don't see the option SSH keys listed, then it is a personal workspace.
If you want to migrate from a personal workspace to a shared one, you can follow the steps in Migrate a Bitbucket Cloud workspace to another workspace. If you want to reuse the ID of the personal workspace in the the shared workspace, you will need to change both the workspace ID of the personal workspace and the username of the associated user to something else in order to free up the ID.
Was this helpful?