Add widgets to a dashboard

VSTS | TFS 2018 | TFS 2017

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

Connect to the web portal for your team project

To add a widget to a dashboard, you connect to your team project using a supported web browser. If you don't have a team project yet, create one in VSTS.

Open a browser window and click the Dashboards hub. If you haven't been added as a team member, get added now.

Open the Dashboards hub

If you don't see the team or team project you want, click the project icon project icon to browse all team projects and teams.

Note

Feature availability: You can access the widget catalog from the web portal for VSTS or TFS 2015.1 or later version. The widget catalog provides widgets for all tiles supported in previous releases of TFS for the team homepage. For on-premises TFS 2015, you can add select charts to the team home page using the Pin to home page feature.

To determine the platform and version you're on, see Provide product and content feedback, Platforms and version support.

Add a widget to a dashboard

Click Edit dashboard icon to modify a dashboard. Click 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.

Note

Feature availability: For VSTS and TFS 2017 and later versions, you can drag and drop a widget from the catalog onto the dashboard.

Widget images may vary depending on which platform you access. This topic shows images that appear in VSTS. However, the widget title and functionality described in this topic are valid for both VSTS and TFS. For example, dashboard edit mode controls shown below are valid for VSTS and TFS 2015.2 and later version. Some functionality differs when you connect to TFS 2015.1 or earlier versions.

Configure a widget

To configure a widget, add the widget to a dashboard and then click the configure icon configure icon.

Work item chart unconfigured widget

Click the delete icon to remove the tile from the dashboard.

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

Edit configured widget

Move or delete a widget from a dashboard

Note

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.

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

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

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

Copy a widget

Note

Feature availability: This feature is only available from VSTS.

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

Copy a widget to another team dashboard

Try this next

Extensibility

In addition to the widgets described in the Widget catalog, you can create your own widgets using the Widget REST APIs.

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

Disabled Marketplace widget

If your account 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.