Add, rename, and delete dashboards in Azure DevOps

TFS 2017 | TFS 2015

When a project is first created, a default team and default team dashboard is created labeled Overview. You can customize this dashboard by adding widgets. Each widget provides access to one or more features or functions. To learn more about each widget, see Widget catalog.


For information on SharePoint dashboards, see Project portal dashboards.



Data displayed within a chart or widget is subject to permissions granted to the signed in user. To learn more, see FAQs on Azure DevOps dashboards, charts, and reports, Access and permissions.

Open Dashboards

Select a dashboard

Add a dashboard

Add a new dashboard as needed to support your team's needs. You can also edit and rename any existing dashboards associated with your team.

Rename, delete, and enable auto-refresh

You can rename or delete a dashboard. When you enable auto-refresh, the dashboard automatically updates every 5 minutes.


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

  1. To manage dashboards, select the configure icon wrench icon.

    Open Manage dashboards dialog

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

    Manage dashboards dialog

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

  4. To delete a dashboard, select the delete icon.

  5. Select Save to save your changes.

You can also manage dashboard permissions.

Move or delete a widget

Just as you have to be a team admin, a project admin, or have the necessary permissions to add items to a dashboard, you must have the necessary permissions to remove items.


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.


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

Try this next

As you can see, you can use team dashboards to provide guidance and keep your team in sync, providing visibility across your org about status, trends, and progress.