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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


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

Undocumented branch restrictions

Although most are self-explanatory, I cannot find information on the different kinds through the branch restrictions documentation. Specifically, I'm interested in two of them, which happen to be accessible only through the API.

What is the definition of require_all_dependencies_merged and require_commits_behind?

1 answer

1 accepted

0 votes
Answer accepted
Ben Atlassian Team Mar 17, 2022


I have reached out to our developers to explain what each of the requested definitions are for the two restrictions you have mentioned.

1.  require_all_dependencies_merged: This is actually accessible in the branch permissions section of the UI "Check that all dependencies are merged".
The purpose behind the feature is that you can link Pull Requests to indicate that one PR was blocked by another, and it would notify you if you tried to merge a PR without all its dependent PRs completed.
2. require_commits_behind: This is not accessible in the branch permissions section of the UI OR in the API. This was a planned feature that has not yet been implemented but is in the works. 
The purpose behind this feature is to establish a limit where if you are trying to merge code into main, you can only be N commits behind whatever the tip of main is at. For example for this PR, if you had a limit of 50 it would block this PR from being merged until you synced up your branch.

Hope this helps.


- Ben (Bitbucket Cloud Support)

Thank you for the response, Ben. I happen to be interested in the require_all_dependencies_merged restriction and I'm happy to see that the option exists.

So, the next question would be, how do you represent the linking of the pull requests? Is there maybe documentation to which you can refer me?

On a side note, I double-checked, and I still don't see the restriction in the UI. Is it maybe a premium feature?

Ben Atlassian Team Mar 28, 2022

Hey @lamprianidis

My apologies, I have checked "require_all_dependencies_merged" on my personal (non-work) account and it is not present - I believe that this is still in testing and has not yet been rolled out to production as of yet.
We do not have formal documentation regarding the pull request linkage, I would imagine that this would become available once the feature is implemented.

Hope this makes sense.


- Ben (Bitbucket Cloud Support)

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events