Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Structure/organization in Bitbucket Cloud

We just got Bitbucket Cloud and I'm gonna be migrating our svn repos to it. I'm thinking about how to organize things.

Bitbucket introduces 2 organization concepts, workspaces and projects. When creating a new repo, you specify the workspace and then the project (projects are specific to a workspace).

The workspace affects the git URL. Your repo's URL will be The workspace names are on a first-come first-serve basis. For example you can't use 'atlassian' as your workspace name since it's already taken. I created a workspace with the name OurCompanyName to reserve it.

Projects seem to be only a basic web interface thing, a simple way to view related repos part of the same project. I guess it becomes more useful as the number of repos grows high.

I can see two approaches:

1) A single flat workspace,, with repos like proj1-repo1.git, proj1-repo2.git, proj1-commonsubmodule.git

2) One workspace per project, so,,

Both work, but the 2nd seems way messier and I'd also be worried about some malicious unrelated user snatching up names like OurCompanyName-something and preventing us from using it. Also I can't seem to find a way to list all workspaces, you have to start typing their names to find them. Not great for discoverability.

How do you organize your repos? One flat workspace?

1 comment

I work on a company team with several dozen active repositories, and we do just fine with a single flat workspace. As you say, "Projects" aren't much more than an organizational taxonomy, and you can freely create/change/delete projects, or move repos between projects, without affecting any functional elements like URLs.

Administrative options—like user/group management, permissions, and billing—are also set at the workspace level, so if you're at all likely to upgrade to a paid plan in the future, a single workspace is going to make your life much easier.

I should note that my team uses BitBucket purely for version control. We don't use Jira, Trello, or any other project management integrations, so I can't speak to how those features might incentivize you toward having multiple workspaces.


Log in or Sign up to comment

Atlassian Community Events