Set dashboard permissions

Azure DevOps Services | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

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 can set individual dashboard permissions for team members. The permissions only affect the team members to which the dashboards belongs.

As a team or project administrator, you can set individual dashboard permissions for team members. The permissions only affect the team members to which the dashboards belongs.

Note

The set dashboard permissions feature is available for TFS 2017.1 and later versions. For TFS 2017 and earlier versions, only team and project administrators can add and edit dashboards.

To learn more 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, and you've set the permissions to allow them to do so, check that they have been added as a member of the team. This includes adding them as a team member to the default project team. For details, see Add users to a project or specific team.

Prerequisites

  • If you haven't been added as a team 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.

Set default dashboard permissions for a project

By default, all team members have permissions to edit dashboards defined for the team. All other valid users of the project have view only permissions, except for members of the Project Administrators group. You can change the default permissions a project from the Project settings.

  1. Choose Project Settings and then Dashboards.

    Web portal, open Dashboards

  2. Check or uncheck those permissions you want to grant or restrict. Your changes are automatically saved by the system.

Set individual dashboard permissions for team members

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

    Web portal, open Dashboards

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

    Here we lock down the permissions for members of the Fabrikam team to edit the Analytics dashboard.

    Permissions for Analytics dashboard dialog

    Note

    The dashboard permissions dialog doesn't support granting permissions to other users or groups at this time.

  3. Choose Save changes and then Close.

Set individual dashboard permissions for team members

By default, all team members have permissions to edit dashboards defined for the team. All other valid users of the project have view only permissions, except for administrators. You can change the view, edit, and manage permissions for all team dashboards for members of your team.

  1. To change the permissions for a specific dashboard, open the dashboard and then choose the configure icon wrench icon for the dashboard.

    For example, here we open the Manage Dashboards dialog for the Fabrikam Fiber Web team's Test dashboard.

    Open Manage dashboards dialog

  2. Choose the Permissions tab and check those checkboxes to grant or restrict permissions to your team members to edit and manage team dashboards. The default settings, as shown in the illustration, provide all team members permissions to edit and manage dashboards.

    Note

    The dashboard security dialog doesn't support granting permissions to other users or groups.

    Manage dashboards - permissions dialog, Azure DevOps and TFS 2018

  3. Choose Save to save your changes and dismiss the Settings dialog.

  1. To change the permissions for a specific dashboard, open the dashboard and then choose the configure icon wrench icon for the dashboard.

    For example, here we open the Manage Dashboards dialog for the Fabrikam Fiber Web team's Test dashboard.

    Open Manage dashboards dialog

  2. Choose the Permissions tab and check those checkboxes to grant or restrict permissions to your team members to edit and manage team dashboards. The default settings, as shown in the illustration, provide all team members permissions to edit and manage dashboards.

    Note

    The dashboard security dialog doesn't support granting permissions to other users or groups.

    Requires TFS 2017.1 or later version.

    Manage dashboards - permissions dialog, 2017.1

  3. Choose Save to save your changes and dismiss the Settings dialog.