GitKraken Desktop Documentation

Pull Requests in GitKraken Desktop

Last updated: March 2026

Use this page to create, review, filter, comment on, and merge pull requests in GitKraken Desktop across supported providers such as GitHub, GitLab, Bitbucket, and Azure DevOps. It also covers GitHub-specific review features such as code suggestions, pull request view, and merge options inside the app.

Requirements and limits

  • Supported providers on this page: GitHub, GitLab, Bitbucket, and Azure DevOps
  • Precondition: Push your branch to the remote before creating a pull request
  • GitHub-specific features: Pull Request View, code suggestions, and in-app merge options
  • Template support: Pull request templates are supported for GitHub, GitLab, and Azure DevOps
  • Azure DevOps note: If the PR form does not populate, verify the remote URL and integration domain on the Azure DevOps integration page
  • Feature scope varies by provider, so some actions described here are GitHub-only
Provider Create PR or MR View PR or MR Merge in app Notes
GitHub Yes Yes Yes Review and suggestion features are strongest here
GitLab Yes Yes Yes Uses merge request terminology
Bitbucket Yes Yes Yes Some reviewer workflows depend on permissions
Azure DevOps Yes Yes Yes Verify remote URL and integration domain if the form does not populate

Quick Start

To create a pull request:

  • Drag one branch onto another in the commit graph and select Start a pull request.
  • Or right-click the target branch and choose the same option.
  • Or click the + icon in the PULL REQUESTS section of the Left Panel.

To review a pull request (GitHub integration):

  1. Select a PR in the Left Panel or click the PR icon in the Launchpad.
  2. Click Review Code and Suggest Changes to open the diff view.
  3. Write suggestions directly in the editor. Suggestions are posted as comments on the GitHub PR.

To merge a pull request: Click Merge pull request in the GitHub PR view and select a merge strategy (merge commit, squash, or rebase).

To filter pull requests: Use predefined filters like “My pull requests” or create custom filters in the Left Panel. PR icons indicate CI status and review state.

Push your branch to the remote before creating a pull request.


How to create a pull request

To create a pull request:

  • Drag one branch onto another and select Start a pull request
  • Or right-click the target branch and choose the same option
  • Or click the icon in the Left Panel PULL REQUESTS section

Use GitKraken Desktop PR creation when: your branch is already pushed and you want to open or manage the PR without leaving the app. Don’t start the PR yet when: the branch is not pushed, the target branch is still unclear, or you need provider-specific options not exposed in GitKraken Desktop.

User initiates a pull request in GitKraken Desktop by dragging a local branch (PM-34-docs-review-pr-page) onto the remote origin/main. The Create Pull Request dialog then appears, pre-filled with repository and branch information, ready for title, description, and assignee input.
Start a pull request by dragging a branch
User clicks the plus button in the Pull Requests section of GitKraken Desktop’s Left Panel to open the Create Pull Request interface. The dialog appears with fields to select repositories, branches, title, description, and other PR options.
Create a pull request from the Left Panel

Note: If the Azure DevOps PR form isn’t populating, see Azure DevOps Integration.


How pull request templates work

GitKraken Desktop supports PR templates on GitHub, GitLab, and Azure DevOps. When committed to the remote, the template appears during PR creation.

GitKraken Desktop interface displaying the Create Pull Request dialog with a dropdown field for selecting a pull request template. The template 'pull_request_template.md' is highlighted.
Pull request template field shown during creation

Tips:

  • Follow your provider’s documentation for file location
  • Ensure the template is on the currently checked out branch

Resources:


How assignees, labels, and reviewers work

Some integrations allow adding:

  • Assignees
  • Reviewers
  • Labels
GitKraken Desktop pull request creation screen showing fields for assigning reviewers, assignees, and labels. Two reviewers, two assignees, and two labels are selected.
Assign reviewers and labels during PR creation

Conflict warnings appear if your source and target branches differ:

GitKraken Create Pull Request screen displaying a warning banner indicating a merge conflict between the source and target branches.
Merge conflict warning in PR modal

Reminder: Push your branch before creating a pull request.


How draft pull requests work on GitHub

With the GitHub integration, select the draft checkbox to mark the pull request as a draft.

Use a draft pull request when: you want early visibility or feedback before the branch is ready to merge. Don’t mark it ready too early when: the implementation still needs major changes and you are not ready for formal review.

GitKraken interface showing the Create Pull Request form with the 'Submit as draft' checkbox enabled.
Enable draft pull request in GitHub

How GitHub Pull Request View works

Enable the GitHub integration to access GitHub PR view:

  • Select a PR in the Left Panel
  • Or click the PR icon in the Launchpad

Use GitHub Pull Request View when: you want to update PR metadata, inspect changes, or suggest edits inside GitKraken Desktop. Don’t rely on it for every review workflow when: your team depends on deeper provider-native review features outside the app.

GitKraken Desktop displaying the GitHub pull request view for PR #1993, which adds Arm64 support for Windows and Linux.
GitHub pull request view in the repo tab
Launchpad view in GitKraken Desktop showing a list of pull requests with an option highlighted to open the pull request panel.
Access PRs from the Launchpad

From this view, GitHub users can edit:

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

Click to review changes.


How to suggest changes

When you click to , this will allow you to write the code suggestion directly in GitKraken Desktop’s editor or gitkraken.dev.

Use code suggestions when: you want to propose concrete edits for the PR author to review or apply. Don’t use suggestions when: you only need a high-level comment or architectural discussion without an exact code change.

User suggesting code changes within a pull request using GitKraken Desktop's review interface
Suggest code changes inside a pull request

All code suggestions are posted a comments in the GitHub pull request conversation with a link to review the code suggestion inside of gitkraken.dev or GitKraken Desktop.


How to accept or reject suggestions

Code suggestions display in the PR view under the “Code Suggestions” label:

Code suggestion label displayed in the PR list and detailed panel in GitKraken Desktop
Label for PRs containing code suggestions

You can apply or reject each suggestion in the Commit Panel:

User applying a code suggestion to the main branch from a pull request in GitKraken Desktop
Review and apply suggestions

How commenting and quoting work

Comment on pull requests, refresh the comments feed, or quote replies:

GitHub Pull Request view in GitKraken Desktop showing reviewers, code diff, and a highlighted refresh comments button
Refresh and quote comments
Highlighted UI option for quoting a reply in a pull request comment thread, with 'Merging is blocked' status below
Reply with quotes

How branch actions and build status work

Double-click a branch in the PR view to check it out. Click build status to open in browser.

Build status section showing a successful Jenkins check completed 15 minutes ago with tooltip 'View Jenkins's latest build'
Check out branches and monitor CI

If the remote isn’t added yet, GitKraken will prompt you to add it.


How to merge in GitHub PR View

Click to merge.

Merge pull request dropdown showing three GitHub merge strategies: Create a merge commit, Squash and merge, and Rebase and merge
Merge using GitHub PR view options

Choose:

  • Create a merge commit
  • Squash and merge
  • Rebase and merge

If data appears out of sync, refresh GitKraken Desktop.


How the active pull requests panel works

Active PRs appear with this icon and are listed in the PULL REQUESTS section of the Left Panel.

GitKraken Desktop interface showing the Pull Requests panel expanded with filters and PR list from the origin remote
Pull request panel and filters

Use predefined filters like My pull requests or All pull requests, or create custom filters.

Tooltips show branch, author, status, and more:

Tooltip showing details of a pull request in GitKraken Desktop, including source and target branches, author, and timestamps
General tooltip details
GitLab tooltip in GitKraken Desktop showing pull request details including branches, author, assignee, and timestamps
GitLab tooltip with an assignee
GitHub tooltip in GitKraken Desktop showing pull request details including title, branches, build status, reviewers, assignees, labels, and timestamps
GitHub tooltip with reviewers and build status

Pull request icons:

  • = CI passed and approved
  • = CI passed/pending or reviews pending
  • = Failing CI or changes requested
Have feedback about this article? Did we miss something? Let us know!
On this page