Dashboards

Last Update: 11/18/2016

Team Services | TFS 2017 | TFS 2015.1-2015.3 | Previous version

Feature availability: Multiple team dashboards and the widget catalog are available from Visual Studio Team Services and from the web portal for TFS 2015.1 or later version.

If you connect to an on-premises TFS running TFS 2015 or earlier version, you don't have access to multiple team dashboards. Instead, your home page serves as a single team dashboard.

Share progress and status with your team using configurable team dashboards. Dashboards provide easy-to-read, easy access, real-time information. At a glance, you can make informed decisions without having to drill down into other parts of your team project site.

The Overview page provides access to a default team dashboard which you can customize by adding, removing, or rearranging the tiles. Each tile corresponds to a widget that provides access to one or more features or functions.

Example dashboard

Anyone with access to the team project, including stakeholders, can view dashboards. However, only team admins can add or modify dashboards.

If you need to add a team first, go here.

Add and name your dashboard

From the dashboards tab, click the plus icon and enter a dashboard name.

Add and name a dashboard

If you don't see the plus icon, then you're not a team admin for the currently selected team. Either switch the context to your team, or request you be added as a team admin.

With the dashboard selected, you can add a widget to the dashboard. Or, you can add a chart to a team dashboard from the Work, Build, or Test hubs.

Edit dashboard

Feature availability: Dashboard edit mode controls shown appear from Team Services or TFS 2015 Update 2 or later version. Some functionality differs when you connect to an application server running TFS 2015 Update 1 or later version.

Add a widget

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.

Feature availability: For Team Services, you can drag and drop a widget from the catalog onto the dashboard.

Configure a widget

After you add the widget, you may need to configure it. For example, to configure the Query tile widget, click the Configure widget icon to open the configuration dialog.

Query tile unconfigured widget

And then select the query and specify any rules you want. (For TFS 2015.1 and later versions, you can only specify the green and red flag limits.)

Team Services configuration dialog for query tile

Query tile configuration dialog

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.

Add an item or a chart to your dashboard

You add an item to a dashboard from the code, work, and build pages.

First, make sure you have the team context selected from the Queries page to which you want to add a query or chart.

For example, select the context menu of a query that you want to add to the dashboard. This is the same as adding a query tile widget.

Add a shared query to a team dashboard

And, you can add a chart to a team dashboard in a similar way.

Add a chart to a team dashboard

Copy a widget

Feature availability: This feature is currently only available from Team Services.

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

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.

Manage dashboards

Feature availability: You can configure the auto-refresh setting for each dashboard on Team Services and for TFS 2015.2 and later versions. Currently, you can set dashboard permissions for Team Services.

You can rename, reorder, or delete a dashboard. Also, you can enable auto-refresh, and the dashboard will automatically update every 5 minutes.

From Team Services and TFS 2017, you can also manage dashboard permissions.


To manage dashboards, click the gear icon gear icon.

Open manage dashboards dialog

Reorder and auto-refresh

  1. Drag and drop the dashboards into the sequence you want them to appear.

    Manage dashboards - Team Services
  2. Click delete icon to delete a dashboard and then click Save.

  3. Select the Auto-refresh checkbox when you want the dashboard to refresh every five minutes.

Set permissions

From the Permissions tab you can grant or restrict permissions to your team members to edit and manage your team dashboards. The default setting provides all team members permissions to edit and manage dashboards.

Manage dashboards - permissions
  1. Click the gear icon gear icon to open manage dashboards.


    Open manage dashboards dialog - TFS web portal
  2. Drag and drop the dashboards into the sequence you want them to appear.

    Manage dashboards
  3. Click delete icon to delete a dashboard and then click Done.


  4. Select the Auto-refresh checkbox when you want the dashboard to refresh every five minutes.

    Feature availability: The Auto-refresh feature is available from TFS 2015 Update 2 or later version.

As you can see, you can use team dashboards to provide guidance and keep your team in sync, providing visibility across the org as to status, trends, and progress. See these additional resources to help you support your team:

Also, you can create a dashboard widget using the REST API service.

Required permissions

If you don't see the plus icon, then you don't have permission to edit your team dashboards. 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.

If you work in Team Services, you can ask your team admin to change dashboard permissions to allow you and other team members to edit dashboards as described here.

Switch team context

Several features depend on the team project or team that you have selected. For example, dashboards, backlogs, and board views will change depending on the context selected.

You navigate to your team context from the top navigation bar.

Choose another team from the team project menu

Choose Browse All if the name you want doesn't appear in the list.

Extensibility

Using the REST API service, you can add a dashboard.

To learn more about the REST APIs for dashboards and widgets, go here.

Provide feedback

We welcome your feedback.

Send suggestions on UserVoice, and follow us on Twitter @VSTeam. Or, tell us what you think with Send-a-Smile on the title bar ... Send-a-Smile.

Or, see our comprehensive feedback and support page.