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

How do you set the default merge strategy?

To configure merge strategies for a repository

  1. In repository settings, select Pull requests.

If I go to my settings page,{repo}/admin

I do not see a Pull Requests section. I do see a Pull Requests section under navigation, but that just lists open pull requests.

5 answers

2 accepted

2 votes
Answer accepted
jredmond Atlassian Team Feb 02, 2017

You're looking at documentation for the self-hosted version of Bitbucket (known as Bitbucket Server). At the moment, there's no option for a default merge strategy in Bitbucket Cloud (

Have a look at for the right set of documentation.

1 vote
Answer accepted

This feature is now available in Bitbucket Cloud. Read more about it here:

@Alastair Wilkes is there a way to set this programmatically via the API? I only see documentation for Bitbucket Server @

@Peter Majeedthanks for your question. At this time, there isn't an API to set this programmatically.

Why even release a feature if you can't do it in both places. We are hacking all over the place hitting cloud endpoints that aren't documented, but totally exist because the app uses them. Why not just document and allow users to have all the wonderful power. Right now we feel hamstrung, or hacky. Either way, this does not give me confidence in Atlassian product quality. Especially when there are solutions like Github getting more and more powerful every day! 

Release a feature with an API used by the GUI, document that API and give it to the people. Anything less is disappointing at best. 

Like # people like this

Thanks for the feedback, John. While we've recently made considerable improvements to the 2.0 APIs, we still have a ways to go -- especially when it comes to repository configuration management.

Hi @Alastair Wilkes ,

Is there any way I can set a default merge strategy to squash for all repositories belonging to a team on Bitbucket Cloud?

I need to define this globally for all repositories not one by one individually.

Or, do that it could be individually per repository if there was an API for it.

We need to do this for our CI/CD process.


Like # people like this

Hi @Michel Zanini,

Thanks for your question. At this time, there isn't an easy way to do that; you'll need to set it one-by-one, in the UI. This is obviously suboptimal, and we need to make this easier in the future.



Any progress on this?

FWIW, there is an issue tracked for this @ Please vote for it. (There is one quasi-workaround at the moment.)

FWIW, we are planning on canceling our subscription with Bitbucket and moving to another provider because of the lack of customizations like this that damages the developer experience.

11 votes

Hi Mike,

That documentation is for Bitbucket Server, which supports the default merge strategy feature.

Bitbucket Cloud is a separate product with a slightly different featureset. A default merge strategy is not yet available, but since we just released squash-on-merge, it's something we want to add to cloud soon.


Hi Alastair,

Any news on this topic? We always squash our branches when merging but developer dicipline is hard to obtain unless enforced so this feature would be much appreciated :)

Desperate for this. +1

Please implement.  This is a great feature to have.



+1  Is there a ticket tracking this feature request? 

Over a year later and no options yet? But hey Stride is out... oh wait we all use Slack. 

Please Atlassian, stop trying to expand and just make your products work... this should be a CORE feature of Bitbucket, not an idea that still isn't implemented after a year.

+1 to get this done.  

@Yohan GREMBERthis feature actually shipped a little while ago! You can read it about it here:

Like Yohan GREMBER likes this


Please add this feature. This is such a minor setting to allow, just do it. We shouldn't need browser extensions to get simple functionality like this.

Suggest an answer

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

📣 Calling Bitbucket Data Center customers to participate in research

Hi everyone, Are you Bitbucket DC customer? If so, we'd love to talk to you! Our team wants to dive deep to understand your long-term plans regarding Bitbucket DC and Atlassian Cloud. Do you plan...

172 views 2 4
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