Skip to content

Pull requests

You can browse and filter pull requests for your GitHub repository from the Pull Requests activity.

To show the Pull Requests activity, click its activity-bar icon or click DevOps > Pull Requests.

To analyze the same filtered pull requests in a wider view, choose Open as Tab from the activity menu, then use View to select Grid, Board, Timeline, Summary, or another reporting view. Reporting is part of the Pull Requests tab; there is no separate PR Report tab. The export action appears in reporting views.

Pull requests are listed numerically and display the following information.

  • Pull request number: The number of the pull request.
  • Pull request name: The name of the pull request.
  • Pull request success badge: The badge that indicates if the pull request passed all automated checks.
  • Timestamp: The amount of time since the pull request was created.

Pull Request view

Click a pull request to open the pull request in the Pull Request view. Click Conversation, Checks, and Changes to change the displayed information of the Pull Request view.

Conversation view

You can view every comment and action of a pull request in the Conversation view. The Conversation view displays the pull request and the following information.

  • State: The status of the pull request, if the pull request is open or merged.
  • Milestone: The milestones associated with the pull request.
  • Assignees: The users assigned to the pull request.
  • Reviewers: The users assigned to review the pull request.
  • Labels: The labels attached to the pull request.
  • Project: The project the pull request is a part of.
  • Linked issues: The issues linked to the pull request.
  • Changes: The amount of additions, deletions, and files changed in the pull request.

Checks view

You can view the automated checks a pull request goes through in the Checks view. Each check indicates if the pull request passed or failed the check.

Click on a check to view the details of the check in the Web Browser tab.

Changes view

You can view each changes file in a pull request in the Changes view. You can filter files by status, file type, viewed and unviewed files, and by file name.

Create a new pull request

To create a new pull request, complete the following steps.

  1. Click DevOps > New PR.
  2. In the New PR tab, select the base and compare branch.
  3. In the Title field, enter the pull request name.
  4. Optional: Add labels, milestones, and assignees to the pull request in the Metadata section.
  5. Enter the pull request description in the Description field and click Create Pull Request.

Filter pull requests

By default, the Pull Requests activity displays all open pull requests in a repository. Click the Switch filter dropdown to select a filter template.

Click the Toggle filter panel icon to open the filter panel. You can filter pull requests with multiple filters at a time. Click Switch to Advanced Query to use GitHub search syntax to apply filters.

Filter panel actions

In the pull request filter panel, click the following icons to perform a filter action.

IconDescription
SaveSaves the changes to the filter template.
Save AsSaves the changes as a new filter template.
Rename filterRenames the filter template.
Revert to saved stateDiscards changes made to the filter template.
Delete this filterDeletes the filter template.
New filter tabOpens a new Pull Request tab for a new filter template.
Duplicate tabCopies the current filter template to a new Pull Request tab.