Copy a dashboard

Azure DevOps Services

Use Copy Dashboard to create a copy of a team or project dashboard. You can copy a dashboard to a different team, the same team, or a different project. The copy operation copies the widgets defined on one dashboard to a new dashboard, and reconfigures them based on a selected team. This feature minimizes the work required to build similar dashboards from scratch.

Note

The Copy Dashboard feature is currently in preview and enabled by default. To access the feature, the Copy Dashboard Experience must be enabled. To learn how, see Manage or enable features.

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

Prerequisites

  • You must be a member of a project. If you don't have a project yet, create one.
  • If you haven't been added as a project member, get added now.
  • Anyone with access to a project, including stakeholders, can view dashboards.
  • To add, edit, or manage a team dashboard, you must have Basic access or greater and be a team admin, a project admin, or have dashboard permissions. In general, you need to be a team member for the currently selected team to edit dashboards.

Open the dashboard you want to copy

All dashboards are associated with either a team or a project. From the Overview>Dashboards page, you can browse all dashboards and see which team they belong to, or if they're a project dashboard.

  1. Open a web browser, connect to your project, and select Overview>Dashboards. The dashboard directory page opens.

    Screenshot of Dashboards Directory.

    It lists dashboards 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.

    Screenshot of Filter the dashboard directory.

  2. If you need to switch to a different project, select the Azure DevOps logo to browse all projects.

  3. 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 the Browse all dashboards option.

    Screenshot of Dashboard selector, Browse all dashboards option.

Copy the dashboard

  1. From the dashboard page, select More actions and then select Copy Dashboard.

    Open the create a dashboard dialog

    If you don't see the More actions icon, make sure that you've enabled the Copy Dashboard Experience preview feature. See Manage or enable features.

  2. Enter a Name and Description for the new 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.

    New dashboard dialog, copy dashboard for a different team.

  3. Select Create.

    The page updates to reflect the new dashboard. The widgets and layout appear the same as the dashboard selected for copy.

    In the background, a folder with the name of the new dashboard is created in Shared Queries. All the queries for the new dashboard are copied to that folder. Query names remain the same. Widgets with a team configuration are 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.

    Screenshot of Shared Queries folder created with copy dashboard experience.

  4. Open each widget as needed to verify or modify the configuration.

Next steps