| title | titleSuffix | description | ms.custom | ms.subservice | ms.assetid | ms.author | author | ms.topic | monikerRange | ms.date |
|---|---|---|---|---|---|---|---|---|---|---|
Add a widget to a team dashboard |
Azure DevOps |
Learn how to select and configure widgets that you add to a team dashboard in Azure DevOps. |
dashboards |
azure-devops-analytics |
0869DB42-6983-49A2-855C-2678CFFF4967 |
chcomley |
chcomley |
quickstart |
<= azure-devops |
04/04/2022 |
[!INCLUDE version-lt-eq-azure-devops]
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. Up to 200 widgets total. 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.
[!INCLUDE temp]
::: moniker range=">= azure-devops-2019"
Note
Widgets specific to a service are disabled if the service they depend on has been disabled. For example, if Boards is disabled, New Work item and all work tracking Analytics widgets are disabled and won't appear in the widget catalog. If Analytics is disabled or not installed, then all Analytics widgets are disabled.
To re-enable a service, see Turn an Azure DevOps service on or off. For Analytics, see enable or install Analytics].
::: moniker-end
All dashboards are associated with a team. You need to be a team administrator, project administrator, or a team member with permissions to modify a dashboard.
::: moniker range=">= azure-devops-2019"
-
Open a web browser, connect to your project, and select Overview>Dashboards. The dashboard directory page opens.
[!div class="mx-imgBorder"]
If you need to switch to a different project, select the :::image type="icon" source="../../media/icons/project-icon.png" border="false"::: Azure DevOps logo to browse all projects.
-
Select the dashboard you want to modify.
::: moniker-end
::: moniker range="tfs-2018"
Open a web browser, connect to your project, and select Dashboards.
Select the team whose dashboards you want to view. To switch your team focus, see Switch project or team focus.
Select the name of the dashboard to modify it.
For example, here we select to view the Work in Progress dashboard.
[!div class="mx-imgBorder"]
If you need to switch to a different project, select the :::image type="icon" source="../../media/icons/project-icon.png" border="false"::: Azure DevOps logo to browse all projects.
::: moniker-end
::: moniker range=">= azure-devops-2019"
To add widgets to the dashboard, select :::image type="icon" source="media/icons/edit-icon.png" border="false"::: Edit.
The widget catalog will automatically open. Add all the widgets that you want and drag their tiles into the sequence you want.
When you're finished with your additions, select Done Editing to exit dashboard editing. The widget catalog will close. You can then configure the widgets as needed.
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.
To remove a widget, select 
More actions and select Delete from the menu.
[!div class="mx-imgBorder"]
::: moniker-end
::: moniker range="tfs-2018"
Select 
to modify a dashboard. Select 
to add a widget to the dashboard.
The widget catalog describes all available widgets, many of which are scoped to the selected team context.
::: moniker-end
Or, you can drag and drop a widget from the catalog onto the dashboard.
::: moniker range=">= azure-devops-2019"
This example shows how to add the Velocity widget available from Analytics to a dashboard.
-
Select
Edit to modify a dashboard. The widget catalog opens. -
In the right pane search box, type Velocity to quickly locate the Velocity widget within the widget catalog.
[!div class="mx-imgBorder"]
-
Select the widget, then Add to add it to the dashboard. Or, you can drag-and-drop it onto the dashboard.
-
Next, configure the widget. For details, see the following articles:
::: moniker-end
Most widgets support configuration, which may include specifying the title, setting the widget size, and other widget-specific variables.
To configure a widget, add the widget to a dashboard, select open the 
menu, and select Configure.
[!div class="mx-imgBorder"]
::: moniker range=">= azure-devops-2020"
Additional information is provided to configure the following widgets:
::: moniker-end
::: moniker range="azure-devops-2019"
Additional information is provided to configure the following widgets:
::: moniker-end
To move a widget, you need to enable the dashboard edit mode. To delete a widget, select the delete option provided from the widget's More actions menu.
::: moniker range=">= azure-devops-2019" Select :::image type="icon" source="media/icons/edit-icon.png" border="false"::: Edit to modify your dashboard. You can then add widgets or drag tiles to reorder their sequence on the dashboard.
To remove a widget, select the actions icon and select the Delete option from the menu.
[!div class="mx-imgBorder"]
When you're finished with your changes, select Done Editing to exit dashboard editing.
::: moniker-end
::: moniker range="tfs-2018"
Select 
to modify your dashboard. You can then drag tiles to reorder their sequence on the dashboard.
To remove a widget, select the actions icon and select the Delete option from the menu.
[!div class="mx-imgBorder"]
::: moniker-end
::: moniker range="tfs-2018"
When you're finished with your changes, select 
to exit dashboard editing.
::: moniker-end
You can copy a widget to the same dashboard or to another team dashboard. If you want to move widgets you've configured to another dashboard, here's how you do it. Before you begin, add the dashboard you want to copy or move the widget to. Once you've copied the widget, you can delete it from the current dashboard.
::: moniker range=">= azure-devops-2019"
To copy a configured widget to another team dashboard, select the actions icon and select Copy to dashboard and then the dashboard to copy it to.
[!div class="mx-imgBorder"]
::: moniker-end
::: moniker range="tfs-2018"
To copy a configured widget to another team dashboard, select
the actions icon and select Add to dashboard and then the dashboard to copy it to.
::: moniker-end
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).
In addition to the widgets described in the Widget catalog, you can:
- Add widgets from the Marketplace.
- Create your own widgets using the Widget REST APIs.
If your organization owner or project collection administrator disables a marketplace widget, you'll see the following image:
To regain access to it, request your admin to reinstate or reinstall the widget.
[!div class="nextstepaction"] Review the widget catalog or Review Marketplace widgets
::: moniker range=">= azure-devops-2019"
- FAQs on Azure DevOps dashboards, charts, and reports
- Analytics-based widgets
- What is Analytics?
- Burndown guidance
- Cumulative flow & lead/cycle time guidance ::: moniker-end
::: moniker range="tfs-2018"