Join or create a workspace

To create or join a workspace, you need an individual Bitbucket account.

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

Any user can create a new workspace and will automatically become a member and administrator of that workspace.

  1. Select your profile and settings 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 (also known as Your profile and settings), select the workspace or click All workspaces for a full list.

  2. Click Settings in the left sidebar.
    The Workspace settings page opens by default.


Additional Help