Using pull requests in Bitbucket Server

Pull requests in Bitbucket Server provide a quick and easy way for software teams to collaborate on code. A pull request is a dedicated forum for discussing a proposed feature. If there are problems with the changes, teammates can post feedback in the pull request and even tweak the feature by pushing follow-up commits. All of this activity is tracked directly inside of the pull request.

A pull request requires differences between two distinct branches. When you create a pull request you'll specify the branch to merge changes into.

Create a branch

Pull requests can be used with the Feature Branch Workflow, the Gitflow Workflow, or the Forking Workflow. You can create branches from the Bitbucket UI, from the command line using Git, or from within a connected JIRA Software instance.

Read about how to create a branch.

Create a pull request

In their simplest form, pull requests allow a developer to notify team members that they've completed a feature. Once their feature branch is ready, the developer files a pull request via their Bitbucket account. This lets everybody involved know that they need to review the code and merge it into the master branch.

Read about how to create a pull request.

Review and discuss a pull request

As a reviewer of a pull request, your colleagues are counting on you to review changes to the code then provide feedback. Use reviewer status indicators to let a pull request author know you approve the changes or that changes need more work before you can approve.

To review a pull request, select either Approve or Needs work within the header of a pull request. Click the button again or click a different one to change your status. 

Approving a pull request lets the author know you reviewed their changes and that you feel the work can merged with the target branch.

Indicating a pull request needs work should accompany a comment to the author letting them know what should change before merging the pull request. Once the author pushes more changes to the pull request, revisit the pull request to review the new iteration. Bitbucket remembers what you've already reviewed and only shows you the changes made since your last visit. At any time you can choose to view the entire effective diff or individual commits and make comments there also.

Read about how to review and discuss a pull request.

Merge a pull request

Once you are ready to merge a pull request, and when the reviewers have approved it, click Merge at the top right of the pull request view. You can merge a pull request if you have write (or admin) permission on the project.

Read about how to merge a pull request.

Last modified on Nov 17, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.