Add and manage dashboards

VSTS | TFS 2018 | TFS 2017 | TFS 2015.1-2015.3

Note

Feature availability: Multiple team dashboards and the widget catalog are available from Visual Studio Team Services (VSTS) 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. For information on SharePoint dashboards, see Project portal dashboards.

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.

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, see add teams and team members.

Connect to the web portal for your team project

To add and manage dashboards, you connect to your team project using a supported web browser. If you don't have a team project yet, create one in VSTS or set one up in an on-premises TFS.

Open a browser window and click the Dashboards hub.

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.

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 widgets and charts to the dashboard. Or, you can add charts to a team dashboard from the Work, Build, or Test hubs.

Manage dashboards

Note

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

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

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

To manage dashboards, click the configure icon wrench 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 - VSTS

  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.

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 VSTS, you can ask your team admin to change dashboard permissions to allow you and other team members to edit dashboards as described in Set permissions.

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.

Try this next

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:

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

Provide feedback

We welcome your feedback.

Send suggestions on UserVoice, and follow us on Twitter @vsts.

See also our comprehensive feedback and support page.