Set dashboard permissions

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dashboards are viewable by all members of the Project Valid Users group. Permissions to edit, delete, or manage dashboards can be configured for both team and project dashboards.

As a member of the Project Administrators group, you can set the default dashboard permissions for all teams. As a team or project administrator, you have the flexibility to set individual dashboard permissions for team members. This enables you to tailor permissions based on the specific needs and roles of each team member. These permissions only impact the team members and their respective team dashboards, allowing for granular control over who can edit, delete, or manage dashboards.

By configuring these permissions, you ensure that only authorized users can make changes to dashboards, maintaining the integrity and organization of your project data.

As a member of the Project Administrators group, you can set the default dashboard permissions for all teams within the project. This allows you to establish a consistent set of permissions across the entire project, ensuring that all teams adhere to the same standards.

As a team or project administrator, you have the flexibility to set individual dashboard permissions for team members. This enables you to tailor permissions based on the specific needs and roles of each team member. These permissions only impact the team members and their respective team dashboards, allowing for granular control over who can edit, delete, or manage dashboards.

By configuring these permissions, you ensure that only authorized users can make changes to dashboards, maintaining the integrity and organization of your project data.

For more information about adding and viewing dashboards, see Add, rename, and delete dashboards.

Tip

If a user reports that they can't create or edit a team dashboard despite having the necessary permissions, ensure they are added as a member of the team. This includes adding them as a member of the default project team. For more information, see Add users to a project or specific team.

Prerequisites

  • Access:
    • All members of the Project Valid Users group can view dashboards.
    • To add, edit, or manage a team or project dashboard, be a member of the team with at least Basic access.
  • Permissions:
    • Team dashboards: To add, edit, or manage a team dashboard, be a team administrator, a project administrator, or have Edit dashboard permissions.
    • Project dashboards: To add, edit, or manage project dashboards, be a project administrator, or have Edit dashboard permissions granted to you.
  • Access:
    • All members of the Project Valid Users group can view dashboards.
    • To edit dashboards, be a member of the team with at least Basic access.
  • Permissions: To add, edit, or manage a team dashboard, be a team administrator, a project administrator, or have specific dashboard permissions granted to you.

Set default team dashboard permissions

By default, all team members have permissions to create and edit dashboards for their teams. All members of the Project Administrators or Project Collection Administrators group and team administrators can set the default dashboard permissions for a team.

  1. Select Project settings > Dashboards.

    Screenshot of Web portal, Project Settings, open Dashboards, Azure DevOps Server 2019.

  2. Move the toggle to enable or disable those permissions you want to grant or restrict.

    The system automatically saves your changes.

Set individual team dashboard permissions

Note

The dashboard permissions dialog currently doesn't support granting permissions to other users or groups. You can only modify the default settings for the team.

  1. Open the Dashboards directory, select the actions icon for the dashboard, and then select the Security menu option.

    Screenshot of Dashboards directory, open Security for a dashboard.

  2. Change Allow or Deny to grant or restrict a permission.

    Here we restrict team members from editing the Analytics dashboard. Only Fabrikam team administrators can edit the Analytics dashboard.

    Dialog for Analytics dashboard Permissions.

  3. Close the dialog.

  1. Open the Dashboards directory, select the actions icon for the dashboard, and then select the Security menu option.

    Screenshot of Dashboards directory, open Security for a dashboard, Azure DevOps Server 2019.

  2. Change Allow or Deny to grant or restrict a permission.

    Here we restrict team members from editing the Analytics dashboard. Only Fabrikam team administrators can edit the Analytics dashboard.

    Permissions for Analytics dashboard dialog, Azure DevOps Server 2019.

  3. Select Save changes and then Close.

Set permissions for a project dashboard

  1. To set permissions for a project dashboard, open the Dashboards directory, select the actions icon for the dashboard, and then select the Security menu option.

    Screenshot of Web portal, open Dashboard security option.

    By default, the creator or owner of the dashboard has all permissions granted to edit, delete, and manage dashboard permissions.

  2. To add another user or group, search for their identity and then select the permission settings that you want.

    Dialog for a Project dashboard, add user and set permissions.

  3. Close the dialog.

  4. Reopen the security dialog to verify the changes were made.

    Project dashboard permissions dialog.