Add widgets to a dashboard

TFS 2017 | TFS 2015

Widgets smartly format data to provide access to easily consumable data. You add widgets to your team dashboards to gain visibility into the status and trends occurring as you develop your software project.

Each widget provides access to a chart, user-configurable information, or a set of links that open a feature or function. You can add one or more charts or widgets to your dashboard. Up to 200 widgets total. You add several widgets at a time simply by selecting each one. See Manage dashboards to determine the permissions you need to add and remove widgets from a dashboard.

Prerequisites

  • You must be a member of a project. If you don't have a project yet, create one.
  • If you haven't been added as a project member, get added now.
  • Anyone with access to a project, including stakeholders, can view dashboards.
  • To add, edit, or manage a team dashboard, you must have Basic access or greater and be added to the team administrator role for the team.

Note

Data displayed within a chart or widget is subject to permissions granted to the signed in user. To learn more, see FAQs on Azure DevOps dashboards, charts, and reports, Access and permissions.

Open a dashboard

All dashboards are associated with a team. You need to be a team administrator, project administrator, or a team member with permissions to modify a dashboard.

Add a widget

Configure a widget

Most widgets support configuration, which may include specifying the title, setting the widget size, and other widget-specific variables.

To configure a widget, add the widget to a dashboard and then select the configure icon configure icon. Work item chart unconfigured widget

Once you've configured the widget, you can edit it by opening the actions menu.

Edit configured widget

Move or delete a widget

To move a widget, you need to enable the dashboard edit mode. To delete a widget, select the delete option provided from the widget's More actions menu.

Just as you have to be a team or project admin to add items to a dashboard, you must have admin permissions to remove items.

To remove a widget, select the widget's Trash icon or Delete icon delete icons.

Widget size

Some widgets are pre-sized and can't be changed. Others are configurable through their configuration dialog.

For example, the Chart for work items widget allows you to select an area size ranging from 2 x 2 to 4 x 4 (tiles).

Change widget size

Extensibility and Marketplace widgets

In addition to the widgets described in the Widget catalog, you can:

Disabled Marketplace widgets

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.

Next steps