Add widgets to a dashboard

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | 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 a team admin, a project admin, or have dashboard permissions. In general, you need to be a team member for the currently selected team to edit dashboards.
  • 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 a team admin, a project admin, or have dashboard permissions. In general, you need to be a team admin for the currently selected team to edit dashboards. Request your current team or project admin to add you as a team admin.
  • 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

Widgets specific to a service are disabled if the service they depend on has been disabled. For example, if Boards is disabled, New Work item and all 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.

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

  1. Open a web browser, connect to your project, and choose Overview>Dashboards. The dashboard directory page opens.

    Web portal, open Dashboards

    If you need to switch to a different project, choose the  Azure DevOps logo to browse all projects.

  2. Choose the dashboard you want to modify.

Open a web browser, connect to your project, and choose Dashboards.

Dashboards directory, previous navigation

Select the team whose dashboards you want to view. To switch your team focus, see Switch project or team focus.

Choose the name of the dashboard to modify it.

For example, here we choose to view the Work in Progress dashboard.

Dashboards, Choose a team dashboard

If you need to switch to a different project, choose the  Azure DevOps logo to browse all projects.

Add a widget

To add widgets to the dashboard, choose  Edit.

The widget catalog will automatically open. Add all the widgets that you want and drag their tiles into the sequence you want.

When you're finished with your additions, choose Done Editing to exit dashboard editing. This will dismiss the widget catalog. You can then configure the widgets as needed.

Tip

When you're in dashboard edit mode, you can remove, rearrange, and configure widgets, as well as add new widgets. Once you leave edit mode, the widget tiles remain locked, reducing the chances of accidentally moving a widget.

To remove a widget, choose the actions icon actions icon and select the Delete option from the menu.

Delete a widget from a dashboard

Choose Edit dashboard icon to modify a dashboard. Choose add a widget icon to add a widget to the dashboard.

The widget catalog describes all the available widgets, many of which are scoped to the selected team context.

Or, you can drag and drop a widget from the catalog onto the dashboard.

Add an Analytics widget

This example shows how to add the Velocity widget available from the Analytics service to a dashboard.

  1. Connect to the web portal for your project and choose Overview>Dashboards.

    Web portal, open Dashboards

    If you need to switch to a different project, choose the  Azure DevOps logo to browse all projects and teams.

  2. Make sure that the Analytics Marketplace extension has been installed. The Analytics widgets won't be available until it is installed.

  3. Choose the dashboard that you want to modify.

  4. Choose edit icon Edit to modify a dashboard. The widget catalog opens.

  5. In the right pane search box, type Velocity to quickly locate the Velocity widget within the widget catalog.

    Velocity widget in widget catalog

  6. Choose the widget, then Add to add it to the dashboard. Or, you can drag-and-drop it onto the dashboard.

  7. Next, configure the widget. For details, see the following articles:

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, choose open the actions icon menu, and select Configure.

Open the create a dashboard dialog

Additional information is provided to configure the following widgets:

Additional information is provided to configure the following widgets:

To configure a widget, add the widget to a dashboard and then choose 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, simply select the delete option provided from the widget's options 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.

Choose  Edit to modify your dashboard. You can then add widgets or drag tiles to reorder their sequence on the dashboard.

To remove a widget, choose the actions icon actions icon and select the Delete option from the menu.

Delete a widget from a dashboard

When you're finished with your changes, choose Done Editing to exit dashboard editing.

Choose Edit dashboard icon to modify your dashboard. You can then drag tiles to reorder their sequence on the dashboard.

To remove a widget, choose the actions icon actions icon and select the Delete option from the menu.

Delete a widget from a dashboard

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

When you're finished with your changes, choose Exit edit-dashboard-mode icon to exit dashboard editing.

Copy a widget

You can copy a widget to the same dashboard or to another team dashboard. If you want to move widgets you have configured to another dashboard, this is how you do it. Before you begin, add the dashboard you want to copy or move the widget to. Once you've copied the widget, you can delete it from the current dashboard.

To copy a configured widget to another team dashboard, choose the Actions icon actions icon and select Copy to dashboard and then the dashboard to copy it to.

Copy a widget to another dashboard

To copy a configured widget to another team dashboard, choose the Actions icon actions icon and select Add to dashboard and then the dashboard to copy it to.

Copy a widget to another team dashboard

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 add widgets from the Marketplace, or create your own widgets using the Widget REST APIs.

Disabled Marketplace widget

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.

Try this next