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

Reduce effort with Branching Model now in Bitbucket Cloud!

Linette Atlassian Team Oct 18, 2018

Hi Bitbucket community friends,

We'd heard that people loved the branching model in Bitbucket Server, because without it inconsistent naming results in slower workflow and general confusion. Then, even when you’ve decided on a naming scheme, it's a pain to keep typing the same thing, and errors easily slip in.

We had a lot of people asking when it was coming to Bitbucket Cloud, so I'm really excited to say that it has!

Basically, when enabled, your default branch type names are set to Bugfix, Feature, Hotfix, and Release (which can be individually turned off, or edited, to match your naming convention, also you can specify other if you need to create a one-off branch with a different name).

Then if you combine this with Branch Permissions, you can make sure all branches of a certain type can only be merged by nominated team members, which reduces the "oooops! I merged to master!!" panics.

As an added bonus if you’ve got Jira and Bitbucket connected, your new branches in Jira Software will automatically select the relevant branch type for the Jira issue type, for example: bug → bugfix/ and story → feature/.

We’ve made this feature available for all Bitbucket repos.  But we don’t want to surprise your team in the middle of working on an existing repo, so you’ll need to specifically enable it to enjoy the benefits. However, new repos will have the feature enabled by default (this can be changed in repository settings).

This is the first step in a set of features to help your teams work with branches more easily, so we are really keen to hear your feedback! You can leave it either here in the comments or use the Feedback button in Bitbucket. Will this make things easier for you? Have you been waiting for it? Is it not quite there yet? How can we help you more?

Looking forward to hearing your thoughts!


Bitbucket Content Designer


Good to see - good start! Requests to improve the feature:

  1. While this is very helpful for branches created within the BB UI and from JIRA, I'd like to see enforcement of the branching model for branches created from the command line, IDE, etc. Currently, with the branching model set, I can create a branch with any prefix. I'd like to restrict it to the prefixes in the repo's configuration.
  2. Provide for default settings that are different from the canned settings, so when a new repo is created, it gets the default settings.
  3. Allow setting the branching model through the API.
Like # people like this
Linette Atlassian Team Oct 29, 2018

Thanks Mark! These are all great ideas, and I can see how they'd be useful. I'll pass them on to the team for consideration.

Loving it! This is a really nice update and the options match almost exactly our existing naming conventions - spooky.

There is one notable exception - "refactor/". We'll often branch to refactor code for greater flexibility, efficiency, performance or security,

I know we can add our own under "other", but if you added this option it would be pretty much perfect for us. 

Like am ️ likes this
Linette Atlassian Team Oct 29, 2018

yay! I'm so glad it's working out for you.

I love the idea of a refactor branch, and it fits very well with the methodology of continuous improvement. I'll pass this recommendation on to the team!

Like Shay Yerushalmy likes this

Thanks, that would be awesome. 

I waited for it very long, thx for implementing it :)

One question about the integration in Jira and Gitflow:

If i start a new branch from a User Story, the new branch with Feature-Namespace has to be taken from develop-branch but there is always the master-Branch preselected. Can I change the presets somewhere? Otherwise this can be really risky ;)

Like # people like this
Linette Atlassian Team Nov 15, 2018

At the moment you can't... buuuuut... watch this space, we've got something coming out in the next few weeks that should make your dreams a reality! :)

Like # people like this

Waiting for this functionality as well ;)


Log in or Sign up to comment
Community showcase
Published in Bitbucket

Git push size limits are coming to Bitbucket Cloud starting April 4th, 2022

Beginning on April 4th, we will be implementing push limits. This means that your push cannot be completed if it is over 3.5 GB. If you do attempt to complete a push that is over 3.5 GB, it will fail...

2,175 views 2 9
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