Create a pull request

When you are ready to start a discussion about your code changes in Bitbucket Data Center and Server, it's time to create a pull request. A pull request is a dedicated forum for discussing proposed changes to a project. To create a pull request you'll need a feature branch that you've made changes to.

To create a pull request:

  1. Select Create pull request in the sidebar.
  2. Choose the source tag or branch and the destination branch. The source branch is where you made your code changes and the destination is the branch you want to merge to. The source and target branches may be located in different forks:

  3. Use the Diff and Commits tabs to compare the source and destination branches before creating the pull request.
  4. Select either Create pull request or Continue, and enter a title and description that will help people understand what your pull request is about. By default, the pull request title will contain the commit message or branch name. The description will populate with any existing commit history if no description template (Data Center only) is being used in the project.
    Use mentions (to notify another user), and markdown (to add formatting) in your description. If there are contributor guidelines available, have a look to make sure you're complying with the repository's owner's rules.
  5. Add individual reviewers or reviewer groups – users will receive a notification by email. Others who have project permissions can participate in the discussion if it interests them.
  6. Select Create.

You will receive email notifications when your reviewers and other participants comment on the pull request or commit changes to it. 

Edit a pull request

After creating a pull request, you can modify it by clicking Edit on the pull request's page. You can edit details such as the TitleDescription, and Reviewers. In particular, you can change the Destination branch for the pull request – you'll need Read permission on the branch you want to set.

Pull request description templates

This feature is available with a Bitbucket Data Center license.

By default, pull request descriptions automatically populate with a list of relevant commit message history. The Description field is how pull request authors can set the context for a code review by adding images, links, or provide instructions for reviewers. Having a custom template for your pull request descriptions in Bitbucket Data Center will save time and help reviewers know what to expect while doing code reviews.

To create a description template:

  1. Go to Project settings > Description template (under pull requests).
  2. Select Create a custom description template for the Template behavior.
  3. Fill out the Description field with the default information or leave it blank to set an empty description value for your template.
  4. Save your changes.

The default description template will automatically be populated into the description field when a new pull request is created in the project. If you do not want to use a template for the description, you can set the Template behavior toggle to Use the commit history as the default description.

Last modified on Aug 31, 2021

Was this helpful?

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