dashboard-permissions.md

title	Set dashboard permissions for team members
titleSuffix	Azure DevOps
description	Learn how to set permissions to create, edit, or delete dashboards in Azure DevOps.
ms.custom	dashboards, engagement-fy23
ms.subservice	azure-devops-analytics
ms.topic	how-to
ms.author	chcomley
author	chcomley
monikerRange	<= azure-devops
ms.date	10/25/2024

Set dashboard permissions

[!INCLUDE version-lt-eq-azure-devops]

::: moniker range="<=azure-devops"

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.

::: moniker-end

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

::: moniker range="<=azure-devops"

Category	Requirements
Access levels	- All members of the Project Valid Users group can view dashboards. - To add, edit, or manage a team or project dashboard: Team member - At least Basic access.
Permissions	- Team dashboards: To add, edit, or manage a team dashboard: Team administrator, project administrator, or Edit dashboard permissions set to Allow. - Project dashboards: To add, edit, or manage project dashboards: Project administrator, or Edit dashboard permissions set to Allow.

::: moniker-end

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.

   [!div class="mx-imgBorder"]
   

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.

::: moniker range="<=azure-devops"

1. Open the Dashboards directory, select the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon for the dashboard, and then select the Security menu option.

   [!div class="mx-imgBorder"]
   

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.

   [!div class="mx-imgBorder"]
   

3. Close the dialog.

::: moniker-end

::: moniker range="<=azure-devops"

Set permissions for a project dashboard

1. To set permissions for a project dashboard, open the Dashboards directory, select the :::image type="icon" source="../../media/icons/actions-icon.png" border="false"::: actions icon for the dashboard, and then select the Security menu option.

   [!div class="mx-imgBorder"]
   

   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.

   [!div class="mx-imgBorder"]
   

3. Close the dialog.

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

   [!div class="mx-imgBorder"]
   

::: moniker-end

Related articles

• Add, rename, and delete dashboards
• Add users to a project or specific team
• Add a team administrator