Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

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
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,831 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you