Fix workspace creation errors in Bitbucket Cloud

Summary

This article helps to fix errors that occur when creating a Bitbucket Cloud workspace. It covers invalid workspace ID formats and other common restrictions.

Cause:

Workspace creation can fail if the workspace ID uses invalid characters, matches your Bitbucket username, or if your organization’s policies restrict workspace creation.

Workspace IDs can only contain lowercase letters, numbers, dashes, and underscores.

In addition, Bitbucket no longer creates personal workspaces automatically for new users.

Solution

Check workspace ID requirements

1. Make sure your workspace ID uses only lowercase letters, numbers, dashes (-), and underscores (_).

2. Do not use uppercase letters, spaces, or other special characters.

3. If an error is observed that the workspace ID is not available, choose a different ID. Workspace IDs that match with the user Bitbucket username are not allowed.

Create a Bitbucket Cloud workspace from Atlassian Administration

1. Log in to Atlassian Administration.

2. Go to the Products tab and select Add product.

3. Choose Bitbucket, then enter the workspace name and workspace ID, and follow the prompts to finish setup.

Review organization restrictions

• If the organization restricts workspace creation, contact the admin team and ask them to grant appropriate access or create the workspace for you.

• Only shared team workspaces can be created. Bitbucket no longer creates personal workspaces automatically for new users.

Troubleshooting tips

• Check any error message carefully for details about invalid characters, unavailable IDs, or restricted actions.

• Try a different workspace ID if your first choice is rejected.

• If you’re blocked at a specific step, contact your organization admin or reach out to Atlassian Support for more help.