GitKraken Desktop Documentation

Downloads  
Contact support  
Feedback  
GitKraken.com  
GitKraken Status  

Pull requests

A pull request (sometimes called merge requests), is a review request. You are asking someone to check the changes on a branch before merging into another branch.


Creating a pull request

If connected to a remote on GitHub, GitLab, Bitbucket, or Visual Studio Team Services, create pull requests by dragging and dropping one branch to another and selecting Start a pull request.

Alternatively, try right-clicking the target branch and selecting Start a pull request.

Or click the in the pull requests section on the left panel, and select the repo and branch to create the pull request.

Pull request templates

GitKraken Desktop supports pull request templates from your GitHub, GitLab, and Azure DevOps (including legacy VSTS URLs).

Once your pull request templates are commited to your remote, the template field will appear when you create a pull request in GitKraken Desktop:

If this is your first time working with pull request templates, consider reviewing the following instructions for GitHub, GitLab, or Azure DevOps pull request templates.

Assignee, Labels, and Reviewers

Some integrations will allow you to also add a pull request assignee and label(s) to your pull request. GitKraken Desktop will then pass these values onto your remote service when the pull request is created.

Note – When creating pull request, GitKraken Desktop will now detect whether your source branch has conflicts with the target branch in the pull request modal.

Depending on the integration, you may also add reviewers and multiple assignees to a pull request.

Note: Because pull requests occur in the remote, first push your branch before creating the request.

Draft Pull Requests

If connected to the GitHub Integration, you may create a draft pull request by checking this box when creating a pull request in GitKraken Desktop.

As the name implies, this will create a “draft” pull request in GitHub. However please note that not all GitHub free or paid plans support the draft feature. Please check your GitHub plan if you do not see this option.


GitHub pull request view

GitHub.com users may utilize the pull request view for GitHub pull requests.

To enable this feature, first set up the GitHub integration. Then with a GitHub repo open inside of GitKraken Desktop, select a pull request in the left panel (or checkout the source branch and a PR icon with the number shows up next to the branch) to bring up the pull request view. Or from the Launchpad, click on the icon at the right side of the Pull Request.

Repository tab:

Launchpad:

From this view, GitHub users may edit the pull request:

  • Title
  • Description
  • Reviewers
  • Assignees
  • Milestones
  • Labels

From the upper right of the Pull Request view, you may click the button to review the affected files for this pull request. Note, code review and code comment are not currently available from within GitKraken Desktop.

Review Code and Suggest Changes

In Gitkraken Desktop, Review Code and Suggest Changes simplifies code review by allowing you to make suggestions and edits across the entire project, not just on the lines that were changed, GitKraken Desktop, and gitkraken.dev. When a Pull Request is open, you can make suggestions to the pull request that others can then review and accept to include in the pull request.

Open the Pull Request and click on , edit the file, save changes and click on

Accept or Reject Code Suggestions

In the Github Pull Request panel, you have the ability to review, accept or reject your teammate’s code suggestions.
A Pull Request with Code Suggestions has the Code Suggestions label in it:

Clicking on one of the Code Suggestions opens the repo tab. The right panel shows a diff with the changes so you can review and two options on bottom Apply suggestion to branch or Reject suggestion.

Comment on GitHub pull requests

Users may comment on a pull request — which is great for submitting reviews, approving pull requests, or requesting changes. You may also use the refresh icon in the top right to quickly refresh the comments feed.

You can also quote other comments in your reply from the elipsies menu

Branch checkout, build status, and adding remote

If you double-click the branch name in the bottom right of the PR view, GitKraken Desktop will automatically check out the branch and open the graph.

If you click on the build status, GitKraken Desktop will take you to the build URL in your default web browser.

Additionally if you have not added the remote, GitKraken Desktop will ask if you wish to add the remote to the app (which should help you review changes locally).

Merging within pull request view

GitHub users may also merge a pull request by clicking the button from within GitKraken Desktop.

By default, the merge will default to the Create a merge commit setting, however you may also choose between Squash and merge and the Rebase and merge,

Not seeing something update in the pull request view? Try refreshing GitKraken Desktop to get the latest updates.


Working with active pull requests

GitKraken Desktop displays active pull requests in your graph with this icon. Pull requests also appear in the left panel PULL REQUESTS section.

Sections in PULL REQUESTS each denote a filtered view of pull requests on this repository. GitKraken Desktop will start with several pull request filters for you, note the filters such as My pull requests and All pull requests. You can modify, delete, or create your own pull request filters.

Quickly search for pull requests using the Search pull requests box.

If using the integration with GitHub, GitLab, Azure DevOps, or Bitbucket, you may hover over the pull request in the left panel to get a quick view of when the pull request was opened and for which branches.

For the GitLab integration, this tooltip will also show any assignee or labels associated with the pull request.

And for GitHub, this tooltip will show assignees, labels, reviewers, and build status.

Pull requests will be marked with one of the following icons:

  • = Continuous Integration checks passed and review(s) have been approved.
  • = Continuous Integration checks passed or are pending and review(s) have been approved or are pending. (excludes above case where CI has passed and reviews are approved)
  • = All other cases, for example Continuous Integration checks failing or review(s) are needed.

Users may also hover the mouse over each icon to gain quick information about the status.

If the branch changes look good after review, you or a reviewer may merge the branch. However if there are outstanding questions or comments, users can leave a comment on the pull request.

If other changes are required, make the change to your code, and then commit and push to your existing branch. Updating your branch updates the pull request too.

Have feedback about this article? Did we miss something? Let us know!
On this page