Open a pull request
The dialog Open a pull request creates a pull request on the provider of the remote. It needs a configured token, see Set up pull requests.
The dialog opens from several places:
| Where | Control | Source branch |
|---|---|---|
| Menu | Git › Open Pull Request… | the checked-out branch |
| Branch context menu in the history, current branch | Open pull request… | the current branch |
| Branch context menu in the history, other branch | Open pull request from "name"… | that branch |
| Notification after a push | Create PR | the pushed branch |
Packages of the Workflow Policy use Open PR… in the Work Packages tab instead. See Work on a package.
Open the pull request
Prerequisite: the source branch is pushed.
- Open the dialog, for example with Git › Open Pull Request….
- Under From → into, check the source branch and select the target branch.
- Check the Title. It defaults to the subject of the latest commit on the source branch.
- Optional: enter a Description (optional). Markdown is supported by both providers.
- Optional: under Reviewers (optional), click the people who should review. A selected reviewer shows ✓.
- Optional: select Open as draft.
- Click Create pull request.
The dialog closes when the provider has created the pull request. If you opened it from the menu or a branch context menu, the Git view then switches to the Pull Requests tab.
Defaults and choices
| Field | Content |
|---|---|
| Source branch | Local branches, and under Remote the remote branches that no local branch tracks. A remote branch is sent without its remote prefix. |
| Target branch | Local branches. The default is develop, then main, then master, whichever exists first. |
| Reviewers (optional) | GitHub: collaborators of the repository. Bitbucket: members of the workspace. With more than 12 people a filter field appears. Selected reviewers stay at the top. |
| Open as draft | GitHub: a native draft. Bitbucket: the title gets the prefix [DRAFT]. |
Create pull request stays disabled while the title is empty or source and target are the same branch.
The notification after a push
After a push, a notification "Pushed branch" asks whether to open a pull request. Create PR opens the dialog with that branch as source. Not now hides the question for that branch for 24 hours. Without a click, the notification disappears after 12 seconds.