AZD: Work with pull requests

The AZD Pull Requests tool window lists the pull requests of the Azure DevOps repository that your project is cloned from. From the list, you open a pull request, create a new one and track your team's review activity.

Tasks for a single pull request have their own topics:

Open the tool window

The tool window is available when the project has a Git remote that points to Azure DevOps Services or Azure DevOps Server. To sign in, see Connect to Azure DevOps.

Open the AZD Pull Requests tool window

Select View | Tool Windows | AZD Pull Requests.
In the main menu, select Git | AZD | Show AZD Pull Requests.
Click the AZD Pull Requests icon on the tool window bar.

If AZD cannot choose the repository and the account on its own, for example because the project has more than one Azure DevOps repository, the tool window asks you to select them. To select them, or to switch later with Change Repository or Account…, see Choose the repository and account.

View pull requests

The Pull Requests tab lists the pull requests of the repository, newest first. When you open the list in a project for the first time, it shows only your own active pull requests (the Includes my changes quick filter). To see all active pull requests, select the Active quick filter; see Quick filters. AZD remembers the last filter for the project.

Each row shows the title, labels and reviewer avatars. The line under the title shows the pull request number, when it was last updated, and when and by whom it was created, for example !42 · updated 2h ago · created Yesterday, by Alex. The last update counts comments, pushes, votes and status changes. AZD shows it only when the pull request changed after it was created.

DRAFT, MERGED, ABANDONED: The state badge of a pull request that is not active.
Comment counter: The comment icon with two numbers, for example 2/5, shows the open comment threads out of all comment threads. Hover over it to see the number of comments and the time of the last activity. Pull requests without comment threads show no counter.
Merge conflict icon: The tooltip Pull request can't be merged means that the source branch conflicts with the target branch. If there are also new changes since your review, the tooltip counts them too.
New changes icon: Someone else pushed to the source branch after your last review. The tooltip shows the number of new pushes and what your last review was, for example you voted 2h ago. See New changes since review.

Double-click a pull request, or select it and press Enter, to open its details in a new tab of the tool window. Right-click a pull request for Show Pull Request, Open Pull Request in Browser, Copy Pull Request URL and Refresh.

By default, the list hides draft pull requests. To show them, click Include Drafts on the list toolbar. To hide them again, click Exclude Drafts. AZD remembers the choice for the project.

Filter and search

Type in the search field to filter the list as you type. AZD matches the text against the title, the description and the number of each pull request. Use the filter buttons under the search field to narrow the list further:

State: All, Active, Merged or Abandoned.
Author, Reviewer: A person in the organization. Type at least 2 characters to search for a user.
Source Branch, Target Branch: A branch of the repository.

If no pull request matches, click Clear filters in the empty list.

Quick filters

Click the filter icon in the search field to open Quick Filters. Every built-in quick filter except Abandoned shows active pull requests only.

Active: All active pull requests.
Includes my changes: Pull requests that you created.
I am a reviewer: Pull requests where you are a reviewer.
Abandoned: Abandoned pull requests.
Waiting for Author: Pull requests where you voted Wait For Author.
I Reviewed: Pull requests that you approved, with or without suggestions.
Awaiting My Vote: Pull requests where you are a reviewer and have not voted yet.
New Changes Since Review: Pull requests with new pushes after your last review; see New changes since review.

Your custom quick filters appear in the same popup.

New changes since review

AZD compares the pushes to a pull request with your last review. Your last review is the latest of these:

Your vote.
Your comment or reply.
Your own push to the source branch.
The moment you marked every file as viewed in AZD.

Votes, comments and pushes count wherever you made them, including the Azure DevOps web page. AZD remembers the viewed mark for 30 days.

A push by someone else after your last review counts as a new change. If you have not reviewed a pull request yet, it has no new changes. Your own pull requests and pull requests that are not active never show new changes.

With the New Changes Since Review quick filter, the list shows Loading review activity… until AZD has checked the pull requests.

Custom quick filters

A custom quick filter saves a combination of criteria under a name, for example "Needs my vote on main".

Create a custom quick filter

In the title bar of the AZD Pull Requests tool window, click Custom Quick Filters (the gear icon). You can also right-click the list and select Custom Quick Filters.
In the Custom Quick Filters dialog, click +.
In the Add Custom Quick Filter dialog, enter a Name.
Under Filter Criteria, set any of State, Sort, Author, Reviewer, Source Branch and Target Branch.
Click OK.

To change or delete a custom quick filter, open the Custom Quick Filters dialog, select the filter and click the edit button or -.

Sort the list

Click the sort icon on the list toolbar and select a Sort by option: Default (newest first), Created Date, Last Updated or Title. Last Updated orders by the last comment, push, vote or status change. Select Descending to reverse the order. AZD remembers the sort order for each project.

Keep the list up to date

To reload the list, right-click it and select Refresh, or press the shortcut assigned to Refresh (see Settings | Keymap).

To refresh the list and open pull requests automatically, select Auto-refresh pull requests and set Interval in seconds in Settings | Version Control | AZD | Preferences. AZD refreshes the list only while its tab is shown. It refreshes an open pull request only while its details tab is shown and has the focus. For all options on this page, see Preferences.

PR metrics

The PR Metrics dashboard summarizes pull request activity in the repository. It needs the IDE's built-in browser (JCEF).

Open the PR metrics dashboard

In the title bar of the AZD Pull Requests tool window, click PR Metrics (the chart icon).
In the PR Metrics editor tab, use the toolbar to set the Time range and to filter by Author, Reviewer and Target branch. The time range goes from Last 7 days to Last year; the default is Last 90 days.

The dashboard shows:

Summary cards: Total PRs, Active, Merged, Avg Cycle Time and Merges / Week.
PR Cycle Time: the time from creation to completion of each merged pull request.
Status Distribution and Review Votes.
The number of pull requests merged per day, week or month, depending on the time range.
Top Authors and Top Reviewers.

Click the maximize button of a widget to enlarge it. For pipeline metrics and agent pools, see AZD: Pipeline metrics and agent pools.

Create a pull request

Click Create Pull Request… (+) in the tool window title bar. For all the ways to start and the fields of the new pull request tab, see AZD: Create a pull request.

11 October 2026