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 in Atlassian Administration

Bitbucket Cloud is now in Atlassian Administration, which means you can manage your Bitbucket users and groups within the same organization where your Jira site and Confluence space are administrated. The information below can also be accessed at Add a new product to your organization | Atlassian Support.

Add Bitbucket Cloud to your organization and create a workspace in your organization in Atlassian Administration

If you already have Atlassian products and/or an organization in Atlassian Administration, you can now create a Bitbucket Cloud workspace in your organization.

  1. Go to the following URL: admin.atlassian.com

  2. Log-in to your Atlassian Administration account.

  3. Select the Products tab on the top navigation bar.

  4. Select the Add product button.

  5. Select Bitbucket from the list of products.

  6. Name your workspace. Workspace ID is auto-created in accordance with your workspace name.

  7. Select the Agree and add button to create your workspace in Atlassian Administration and agree to the Atlassian Cloud Terms of Service and Privacy Policy.

You should now have a workspace in Bitbucket Cloud for your organization within Atlassian Administration.

Access your new workspace in Atlassian Administration

  1. Log-in your Bitbucket Cloud account.

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

  3. Select User management under the Atlassian Admin heading in the Settings dropdown. This lands you on the Users page in your workspace in Atlassian Administration.

For more information on administering your users and groups in Atlassian Administration, check out our collection of help documentation: Manage your organization’s users.


Create a workspace in Bitbucket Cloud

This process does not provide you access to Atlassian Administration or Atlassian Access. If you want to add Bitbucket to your organization in Atlassian Administration, follow the steps above.

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. By default, your workspace is private. You can deselect the checkbox to make it public.

  7. Select the reCAPTCHA checkbox to ensure us that this is you who is creating the workspace.

  8. 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