Copy a dashboard
Azure DevOps Services | Azure DevOps Server 2022
You can create a new dashboard by copying the widgets from an existing one and adjusting them for a different team or project. This way, you don’t have to start from scratch when you want to make a similar dashboard. To copy a dashboard, you begin with the source dashboard and then select the destination team and the destination project. The copied dashboard has the same widgets as the source dashboard, but you can configure them according to the team you chose.
To create a dashboard for a team or project, see Add, rename, and delete dashboards. To add a team or project, see Add a team or Create a project.
Note
This feature is available starting in Azure DevOps Server 2022.1.
Prerequisites
- Project membership: Be a member of the project.
- Access:
- Anyone with access to a project, including Stakeholders, can view dashboards. However, to view queries or work items displayed in a dashboard widget, have permissions to view the query and work items. For more information, see Set permissions on queries and query folders and Set work tracking permissions.
- Have at least Basic access.
- Permissions:
- Be a member of the team, a team administrator, a project administrator, or have Edit dashboard permissions.
- Have Edit permissions for a shared queries folder, to copy queries to.
Open the dashboard you want to copy
Do the following steps to open the source dashboard.
Sign in to your project (
https://dev.azure.com/{Your_Organization}/{Your_Project}).Select Overview > Dashboards. The dashboard directory page opens.
Dashboards get listed in the following order:
- Your last visited dashboard
- Your favorited dashboards
- All dashboards of teams that you belong to
- All dashboards defined for the project in alphabetical order.
Select the
filter icon to filter the list by keyword or team. Keywords apply to dashboard titles, descriptions, and team names.
(Optional) To switch to a different project, select the
Azure DevOps logo to browse all projects.(Optional) If you open a dashboard, you can select a different dashboard from the directory list, or from the selector. To return to the dashboard directory, select Browse all dashboards.
Copy the dashboard
Do the following steps to copy the source dashboards and create your new dashboard with it.
From the Dashboards page, select
More actions and then select + Copy Dashboard.
Enter a Name and Description for the new dashboard. Make sure you specify a unique name for the dashboard. To copy the dashboard as a team dashboard, select Team Dashboard and then select the Project and the Team. To copy the dashboard as a project dashboard, select Project Dashboard and then the Project.
Here we choose to copy the Fabrikam Fiber project - Fabrikam Team Bug Activity dashboard to the Design Agile project, Design Agile team dashboard.
Check the Select folder to copy dashboard queries checkbox to choose the folder into which dashboard queries get copied. Make sure to select a folder where you have permissions to contribute queries. When you copy dashboards to a different project, this checkbox is automatically selected and requires you to select a folder in the project.
Select Create.
The page updates to reflect the new dashboard. The widgets and layout appear the same as the copied dashboard.
In the background, a folder with the name of the new dashboard gets created in Shared Queries. All the queries for the new dashboard get copied to that folder. Query names remain the same. Widgets with a team configuration get updated with the new team. Widgets with a team configuration that are copied from a team dashboard to a project dashboard retain the original configuration.
(Optional) Open each query and widget in the new dashboard, as needed, to verify or modify the name and configuration. Dashboard widget changes automatically update.