Muokkaa

Jaa


View, filter, and open pull requests

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.

List pull requests

You can list PRs by using the Azure DevOps project website, Visual Studio, or the Azure DevOps command line.

  1. To list PRs in a specific repository in a project, go to that project in the web portal and select Repos > Pull requests.

    Screenshot of viewing your pull requests.

  2. Verify that you selected the correct repository.

    Screenshot of choosing your repo.

  3. 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.

    Screenshot of the view tabs for PRs in Azure Repos.

  4. You can list all of your PRs across different projects in your organization by choosing Pull requests in the My Work view.

    Screenshot of viewing all your pull requests.

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.

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.

Screenshot showing the Customize view button 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.

Screenshot showing the Customize view page with the Add section button.

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.

Screenshot showing the Customize section page.

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. Screenshot of the Pull Requests page showing collapsible sections.

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.

Screenshot of the Files tab with filter 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.

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.

Screenshot that shows the P R Overview tab.

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.

Screenshot of Azure Repos P R screens on a mobile device.

Next steps