Add and manage dashboards
VSTS | TFS 2018 | TFS 2017 | TFS 2015.1-2015.3
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
Open a browser window and click the Dashboards hub.
If you don't see the team or team project you want, click the project icon to browse all team projects and teams.
Add and name your dashboard
From the dashboards tab, click the and enter a dashboard name.
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.
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 wrench icon.
Reorder and auto-refresh
Drag and drop the dashboards into the sequence you want them to appear.
Click to delete a dashboard and then click Save.
Select the Auto-refresh checkbox when you want the dashboard to refresh every five minutes.
If you don't see the , 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
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 to modify your dashboard. You can then drag tiles to reorder their sequence on the dashboard.
To remove a widget, click the widget's or delete icons.
When you're finished with your changes, click 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:
We welcome your feedback.
See also our comprehensive feedback and support page.