- Article
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
You create pull requests (PRs) to review and merge code changes in a Git repository on Azure Repos. Team members and stakeholders can review changes and give feedback before merging the code into the target branch. Reviewers can also comment on changes and vote to approve or reject the code.
Teams can require PRs for any changes on protected branches, and set branch policies to require certain PRs to meet specific criteria.
There are several ways to list, filter, view, and open PRs for a project.
Prerequisites
Repos must be enabled on your project. If the Repos hub and associated pages don't display, see Turn an Azure DevOps service on or off to reenable Repos.
To view PRs, you must be a member of the Azure DevOps project the PR is in, with Basic access or higher. If you aren't a project member, get added.
Note
For public projects, users granted Stakeholder access have full access to Azure Repos.
- Repos must be enabled on your project. If the Repos hub and associated pages don't display, see Turn an Azure DevOps service on or off to reenable Repos.
- To view PRs, you must be a member of the Azure DevOps project with Basic access or higher. If you aren't a project member, get added.
- For more information about permissions and access, see Default Git repository and branch permissions and About access levels.
- In Azure DevOps Services, you can manage PRs and other resources from the Azure command-line interface (CLI) with the
azure-devopsextension. To learn how to work with the Azure DevOps Services CLI, see Get started with Azure DevOps CLI. Azure Repos CLI commands for PRs use az repos pr.
List pull requests
You can list PRs by using the Azure DevOps project website, Visual Studio, or the Azure DevOps command line.
- Browser
- Visual Studio
- Azure DevOps CLI
To list PRs in a specific repository in a project, go to that project in the web portal and select Repos > Pull requests.
Verify that you selected the correct repository.
The default view shows your PRs under the Mine tab. Select Active to show all active PRs for the current repository. Select Completed or Abandoned to bring up lists of closed PRs.
Select any PR in the list to go to that PR's Overview page.
You can list all of your PRs across different projects in your organization by choosing Pull requests in the My Work view.
Define a custom pull request view
Filtering the PR list helps you find and organize PRs to prioritize the most important files in your workflow.
- Browser
- Visual Studio
- Azure DevOps CLI
To filter the PR list, on the Pull requests page, select the Filter icon at upper right. Then select Target branch or other column header, and select the branch or other value you want to filter on.
To further customize your view of the PR list, select Customize view at upper right on the Pull requests page.
On the Customize view page, you can rearrange the current view sections, edit them, or remove them. To create a new section, select Add section.
On the Customize section page, enter and select values to filter the section by parameters like draft state or updated date. You can choose whether to Show pull requests I've approved or rejected on a separate tab, or Exclude pull requests (duplicates) included in previous sections. When you finish customizing the view, select Save.
These customized views create separate, collapsible sections on the pull request page. These custom queries also work across repositories on the My pull requests tab of the organization home page.
To change the parameters of the customized views, select the Customize button next to the view. Or select Customize view, and on the Customize view screen, select the view you want to change. Some views, like Assigned to me, can't be customized, but they can be rearranged or removed.
On a PR Files tab, you can use several filters to select files and comments for faster reviews. Select Filter, and then select among the options.
- Keyword: Enter a keyword.
- Reviewed/Unreviewed: All (default), Pending, Reviewed.
- Commented files: All files (default), Files with comments.
- Comments: Show (default), What's new, Hide.
- Comment status: Active (default), Pending, Resolved, As designed, Won't fix, Closed.
- Commented by: All comments (default), or a specific person.
You can also type a string into the Search field to show matching results from the preceding options.
Open a pull request
When you open a PR from the browser, from Visual Studio, or from Azure CLI, the PR Overview page opens in the browser.
- Browser
- Visual Studio
- Azure DevOps CLI
To open a PR in the browser, select the PR from the list on the Pull requests page. The PR opens to its Overview tab. The Overview tab shows the PR title, description, reviewers, linked worked items, history, and status. You can see a summary of branch policies that are passing or failing, and see comments reviewers have made.
On the PR Files tab, you can review the actual changes in the PR files. On the Updates and Commits tabs, you can see changes the author has made to update the PR branch.
To review changes, make comments or suggestions, or approve or vote on the PR, see Review pull requests.
View and update pull requests from a mobile device
You can use mobile devices to view all Azure Repos PR screens and take actions.
Next steps
Review pull requests
Related articles
- Create a pull request
- Pull request update notifications
- Complete a pull request
- Change the default branch
- Copy changes with cherry-pick
- About pull requests and permissions
