Creating and Editing Pull Requests
Creating a Pull Request
Open the Create Pull Request dialog in one of these ways:
- Click Create Pull Request in the Bitbucket Pull Requests tool window toolbar.
- Right-click a pull request in the list and select Create Pull Request.
Create Pull Request in the Bitbucket Pull Requests tool window toolbar.Then fill in the dialog:
| Field | Description |
|---|---|
| Source repository | The repository the changes come from. If the repository has forks, you can select a fork as the source. |
| Source branch | The branch with your changes. Start typing to get branch-name completion. |
| Destination branch | The branch you want to merge into. Defaults to the repository's main development branch. |
| Title | The pull request title. |
| Description | A Markdown description. See Title and description. |
| Reviewers | People asked to review the pull request. |
When you set or change the source and destination branches, the plugin automatically suggests a Title, Description, and default Reviewers based on the commits between the two branches. Suggestions only replace fields you haven't edited yourself.
The following options are also available:
- Mark as draft — create the pull request as a draft. On Bitbucket Data Center, requires version 8.18 or later.
- Close the source branch after the pull request is merged (Cloud only) — the plugin remembers your last choice.
Click OK to create the pull request. A notification confirms the new pull request and lets you open it or copy its link.
Title and Description
The description editor supports Markdown formatting (using the toolbar above it) and lets you mention users by typing @.
On Bitbucket Cloud, attachments can't be added while creating a pull request. Add them afterward from the Info tab of the details panel.
When creating a pull request, the Actions link next to the Description label offers:
- Insert Commits at Caret — insert a summary of the commits between the source and destination branches at the cursor position. Available when the source is the repository itself, not a fork.
- Reset to Default — restore the default description.
Editing a Pull Request
To edit an existing pull request, open it and click Edit Pull Request on the Info tab toolbar. The same dialog opens, pre-filled with the current values.
Edit Pull Request on the Info tab toolbar. The same dialog opens, pre-filled with the current values.You can change the title, description, destination branch, reviewers, and draft status. The source repository can't be changed; the source branch can be changed on Bitbucket Cloud only. OK stays disabled until you make a change.