Join or create a workspace

To join or create a workspace, you need an individual Bitbucket account. Once you have created your Bitbucket Cloud account, you can join an existing workspace by accepting the invite sent to your email inbox or contact your Bitbucket Cloud administrator to get access.

Whoever creates the workspace automatically has administrative access. That user can also specify admin access for other members of the workspace, giving them the ability to administer the team. Any admin can update the workspace's plan and credit card details.

Create a workspace

If a workspace doesn’t already exist that you can join to start collaborating with your team, you will want to create a workspace for yourself and to be able to invite others to collaborate on any projects. Any user can create a new workspace and will automatically become a member and administrator of that workspace.

  1. Select Your profile avatar in the upper-right corner of the top navigation bar.

  2. Select All workspaces from the dropdown menu.

  3. Select the Create workspace button in the upper-right corner of the Workspaces page.

  4. Enter a Workspace name. This name is what you see in the navigation in Bitbucket and what the other members of your workspace see in their invitation emails.

  5. Enter a Workspace ID. Your ID can't have any spaces or special characters, but numbers and capital letters are fine. This ID becomes part of the URL for the workspace and anywhere else where there is a label that identifies the team (API's, permission groups, OAuth, etc.).

  6. Click Create.

For information on how to add members or groups to your workspace or to grant access to existing repositories in your workspace, refer to Grant access to a workspace.

Update your Workspace settings

You can update your Workspace settings only if you have administrative permissions. If you think you should have admin permissions, ask another administrator to grant you access. If you have admin permission, find your Workspace settings with the following steps:

  1. From your profile avatar, select the workspace or click All workspaces for a full list.

  2. Select the Settings cog on the top navigation bar.

  3. Select Workspace settings from the Settings dropdown menu.
    The Workspace settings page opens by default.

Bitbucket Cloud is scoped to provide you (a member of the workspace) all the content you have permission to access within a single workspace. If you work in or are a member of more than one workspace, you can switch between workspaces.

  1. Select Your profile avatar in the upper-right corner of the top navigation bar.

  2. Select a workspace from the Recent workspaces list, or select All workspaces to display a list of all the workspaces in which you are a member and select the appropriate workspace from the list.


Additional Help