Pull requests
You can browse and filter pull requests for your GitHub repository from the Pull Requests activity.
Navigate 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.
- Click DevOps > New PR.
- In the New PR tab, select the base and compare branch.
- In the Title field, enter the pull request name.
- Optional: Add labels, milestones, and assignees to the pull request in the Metadata section.
- 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.
| Icon | Description |
|---|---|
| Save | Saves the changes to the filter template. |
| Save As | Saves the changes as a new filter template. |
| Rename filter | Renames the filter template. |
| Revert to saved state | Discards changes made to the filter template. |
| Delete this filter | Deletes the filter template. |
| New filter tab | Opens a new Pull Request tab for a new filter template. |
| Duplicate tab | Copies the current filter template to a new Pull Request tab. |