Widget catalog

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015

Widgets display information and charts on dashboards. Many of them are configurable and display information available from one or more data stores or charts maintained within the system.

To add a widget to a dashboard or copy a widget from one dashboard to another, see Add a widget to a dashboard.

The following widgets are organized under the service they support. Widgets that derive their data from Analytics are annotated with Analytics.

Note

Widgets specific to a service are disabled if the service they depend on has been disabled. For example, if Boards is disabled, work tracking Analytics widgets are disabled and won't appear in the widget catalog. To re-enable a service, see Turn an Azure DevOps service on or off.

Azure Boards widgets

Work widgets

Assigned to me

Assigned to me widget

Displays the list of work items currently assigned to the currently logged in user. The list ignores closed or deleted work items.


Burndown chart

Burndown chart widget

Adds a tile that displays a burndown chart which you can configure to span one or more teams, work item types, and time period. With it, you can create a release burndown, sprint burndown, or any burndown that spans teams and sprints. To learn more, see Configure a Burndown or Burnup widget.


Burnup chart

Burnup chart widget

Adds a tile that displays a burnup chart which you can configure to span one or more teams, work item types, and time period. With it, you can create a release burnup, sprint burnup, or any burnup that spans teams and sprints. To learn more, see Configure a Burndown or Burnup widget.


Chart for work items

Chart work item query widget

Adds a tile to display a progress or trend chart that builds off a shared work item query.
From the configuration dialog, select a shared query and specify the chart type and values.

Requires TFS 2015.2 or later version. For TFS 2015.1 and earlier versions, see Add charts to a dashboard to add shared query charts to a dashboard.


Cumulative flow diagram

Cumulative flow diagram widget

Displays the cumulative flow of backlog items based on the time frame, team, backlog level and swimlane you select.

From the configuration dialog, specify the team, backlog level, and other parameters you want.

Hover over each color within the chart to see the count of items for a particular Kanban column.


Cycle time

Cumulative flow diagram widget

Displays the cycle time of work items closed in a specified timeframe for a single team and backlog level. The cycle time of a work item is defined as the time taken to close a work item after work on it has started.

Each marker on the chart corresponds to one or more work items with a particular cycle time. The lower the cycle time, the faster work is progressing through your development pipeline. To learn more, see Configure a Burndown or Burnup widget.


Lead time

Lead time widget

Displays the lead time of work items closed in a specified timeframe for a single team and backlog level. The lead time of a work item is defined as the time taken to close a work item after it was created.

Each marker on the chart corresponds to one or more work items with a particular lead time. The lower the lead time, the faster work is being delivered to the customer.

To learn more, see Lead time and cycle time control charts.


New Work item

New work item widget

Enables you to add work items from the dashboard. You use work items to plan and track work.

Work items that you add using this widget are automatically scoped to the team's default area path and the team's current sprint or default iteration. To change team defaults, see About teams and Agile tools.

Requires TFS 2015.1 or later version.


Other links widget

Provides links to the following features:

The following links are displayed when the corresponding resource is configured for the project:

Other links widget


Query results

Query results widget

Adds a configurable tile that lists the results of a shared query. From the configuration dialog, select either a team favorite or shared query.
To create a shared query, see Use the query editor to list and manage queries.


Query tile

Query tile widget

Adds a configurable tile to display the summary of a shared query results. From the configuration dialog, select either a team favorite or shared query. You can optionally specify rules to change the query tile color based on the number of work items returned by the query. To create a shared query, see Use the query editor to list and manage queries.


Sprint burndown (Analytics)

Sprint burndown widget

Adds a team's burndown chart for a sprint to the dashboard. This widget is based on Analytics data. You have several configuration options for this widget, including selecting a team, iteration, and time period. Teams use the burndown chart to mitigate risk and check for scope creep throughout the sprint cycle.


Sprint burndown (Legacy)

Sprint burndown widget

Adds the team's burndown chart for the current sprint to the dashboard. This chart always displays data for the current sprint. Teams use the burndown chart to mitigate risk and check for scope creep throughout the sprint cycle.

Sprint burndown

Sprint burndown widget

Adds the team's burndown chart for the current sprint to the dashboard. This chart always displays data for the current sprint. Teams use the burndown chart to mitigate risk and check for scope creep throughout the sprint cycle.


Sprint capacity

Sprint capacity widget

Inserts the team's capacity bar chart for the current sprint. To plan and monitor their sprint resources, team set capacity and update Remaining Work throughout the sprint. See Set capacity.


Sprint overview

Sprint overview widget

Inserts a configurable overview of sprint progress. You can choose between a count of story points or number of work items. Teams plan their sprints by defining sprints and assigning backlog items to an iteration.

Inserts a visual overview of sprint progress indicating the number of backlog items in progress, completed, or not started. Teams plan their sprints by defining sprints and assign backlog items to an iteration.


Velocity

Sprint velocity widget

The velocity widget tracks a team's capacity to deliver work sprint after sprint. You configure the widget by selecting a team, a work item type, an aggregation field, and the number of sprints. The widget takes advantage of Analytics data. You can track the velocity for a single team, not multiple teams.

For additional guidance, see Velocity.


Work links widget
Provides quick access to open the following Agile tools and team resources:


Azure Repos widgets

Code widgets

Code tile

Code tile widget

Adds a configurable tile to display the summary of a code folder or Git repository. To configure, simply choose the added tile, select a repository, select a branch (Git only) and select a path. The code tile supports both TFVC and Git repositories.

Requires TFS 2015.1 or later version.


Pull request

Pull request widget

Adds a configurable tile to display active pull requests requested by the team, or assigned to or requested by the person logged in. Select the Git repository for the pull requests of interest.

You need to add a widget for each Git repository of interest. To learn more about pull requests, see Review code with pull requests.

Requires TFS 2015.2 or later version.


Azure Pipelines widgets

Build and Release widgets

Chart for build history

Build history widget

Adds a tile to display a histogram of all builds run for the configured build pipeline. From the configuration dialog, select the build you want to monitor. Hover over a bar to learn how long the build took to complete. Choose the bar to open the summary for that specific build. Bar color indicates: green-completed, red-failed, and yellow-completed without tests.

Requires TFS 2015.2 or later version. For TFS 2015.1 and earlier versions, see Add charts to a dashboard to add a build summary chart to a dashboard.


Deployment status

Deployment status widget

Configurable widget that shows a consolidated view of the deployment status and test pass rate across multiple environments for a recent set of builds. You configure the widget by specifying a build pipeline, branch, and linked release pipelines.

In order view the test summary across multiple environments in a release, the widget provides a matrix view of each environment and corresponding test pass rate. You can choose any cell to see a more detailed view for the selected environment.

Requires TFS 2017.1 or later version.


Release pipeline overview

Release pipeline overview widget

Configurable widget that you can use to view and track the status of a release pipeline. This widget shows the release as a series of environments, with the name of the release and the date or time it was started. The color of the heading and the icon in each environment indicate the current status of the release, which are the same as are used on the Releases page. Select a release pipeline in the left column to filter the list to just releases for that pipeline.


Requirements quality

Requirements quality widget

Configurable widget that you can use to track quality continuously from a build or release pipeline. The widget shows the mapping between a requirement and latest test results executed against that requirement. It provides insights into requirements traceability e.g. requirements not meeting the quality, requirements not tested etc. To learn more about setting up traceability see Requirements traceability


Azure Test Plans widgets

Test widgets

Chart for test plans

Chart work item query widget

Adds a configurable widget that lets you track the progress of test case authoring or status of test execution for tests in a test plan. Get started by selecting a test plan and a test suite. Then select test case chart for test authoring progress or test results for test execution progress. Finally, select the chart type and the pivots.

To learn more, see Track your test results.

Requires TFS 2017.2 or later version.


Test results trend

Test results trend widget

Adds a configurable tile that displays the trend of test results, such as passed or failed tests, for the selected build or release pipeline. The widget helps you visualize the test trends over a period of time, thereby surfacing patterns about test failures, test duration etc.

From the configuration dialog, select the build or release whose test results you'd like to monitor. There are multiple chart options to choose from (Line, Column & Stacked Column) based on your preference. Optionally you can map the trend of test duration on the existing chart by adding a secondary line chart.

The widget provides the basic trend of the test results. To get deeper insights and higher configurability view Test Analytics


Test Results Trend (Advanced)

Test results trend widget

The Test Results Trend (Advanced) widget provides near real-time visibility into test data for multiple builds and releases. The widget shows a trend of your test results for selected pipelines. You can use it to track the daily count of test, pass rate, and test duration. Tracking test quality over time and improving test collateral is key to maintaining a healthy DevOps pipeline.

The widget supports tracking advanced metrics for one or more build pipelines or release pipelines. The widget also allows filtering of test results by outcome, stacking metrics, and more.

To learn more, see Configure the Test Results Trend (Advanced) widget.


Embedded web page

Embedded web page widget

Adds a configurable tile to display the contents of a web page. Only webpages that allow iframe embedding are supported.


Markdown

Markdown widget

Adds a configurable tile to display any type of information, guidance, or links that you want. You can also configure the widget to point to a file stored in your repository. From the configuration dialog, add the information you want to share with your team. To learn more, see Add Markdown to a dashboard.

Adds a configurable tile to display any type of information, guidance, or links that you want. From the configuration dialog, add the information you want to share with your team. To learn more, see Add Markdown to a dashboard.

Requires TFS 2015.1 or later version. For TFS 2015.2 or later versions, you can configure the widget to point to a file stored in your repository.


Team members

Team members widget

Shows team member profiles and, on-hover, their user alias. For team admins, supports access to the quick dialog to add or remove team members.

Note

This widget is a convenient way to add team members to specific teams within projects. If you remove it, you can still add members to your team from the team administration page.

Requires TFS 2015.1 or later version.


Team room

Team room widget

Provides status and access to team rooms. Available for TFS 2015.1 through TFS 2017.2 versions.

Team rooms support increased team productivity by providing a space to discuss work in progress, ask questions, share status, and clarify issues that arise. Team administrators can create additional team rooms.

Note

Team Rooms have been deprecated as described in Deprecation of Team Rooms blog post. Several good solutions are available that integrate well with TFS that support notifications and chat, such as Microsoft Teams and Slack.


Visual Studio Shortcuts

Visual Studio widget

Provides links to open or download Visual Studio. The Visual Studio IDE client comes with the Team Explorer plug-in which provides quick access to several features (some of which aren't available through the web portal).

Requires TFS 2015.1 or later version.


Welcome

How to links widget

Provides links to the Boards/Boards (Work/Boards), Repos (Code), and Pipelines (Build or Build-Release) pages and reference documentation on how to add charts.

Requires TFS 2015.1 or later version.


Marketplace widgets

You may find additional widgets of interest from the Marketplace.

If your organization owner or project collection administrator disables a marketplace widget, you'll see the following image:

Disabled widget extension notification

To regain access to it, request your admin to reinstate or reinstall the widget.

Extensibility

Using the REST API service, you can create a dashboard widget. To learn more about the REST APIs for dashboards and widgets, see Dashboards (API).