This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Manage usersManage teams

Manage teams

A team is a group of users assigned to an organization on a Grafana server. Each user can belong to more than one organization and more than one team. Teams are generally managed by Organization Admins, but they can also be managed by Editors if the editors_can_admin server setting is set to true. For more information, refer to Organization roles.

Teams members are assigned one of two permissions:

  • Member - Required to be a member of the team.
  • Admin - A member of the team that can also manage team membership, change team permissions, change team settings, and add or delete the team.

Note: You must have Organization Admin or Team Admin permissions, or Editor permissions with editors_can_admin selected, in order to perform the tasks described in this page. Team Admins can only perform tasks that apply to their specific team.

View team list

See the complete list of teams in your Grafana organization.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.

Org Admin view

Team list

Team Admin view

Team list

Create a team

Add a team to your Grafana organization.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.
  3. Click New Team.
  4. Enter team information:
    • Name - Enter the name of the new team.
    • Email - (Optional) Enter the team email.
  5. Click Create.

Add a team member

Add an existing user account to a team.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.
  3. Click the name of the team that you want to add users to.
  4. Click Add member.
  5. In the Add team member list, click the user account that you want to add to the team. You can also type in the field to filter the list.
  6. Click Add to team.
  7. Repeat the process to add more team members.

Add team member

Remove a team member

Remove a user account from the team.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.
  3. Click the name of the team that you want to remove users from.
  4. Click the red X next to the name of the user that you want to remove from the team and then click Delete.

Set team member permissions

Change team member permission levels.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.
  3. Click the name of the team in which you want to change user permissions.
  4. In the team member list, find and click the user account that you want to change. You can use the search field to filter the list if necessary.
  5. Click the Permission list, and then click the new user permission level.

Change team member permissions

Delete a team

Permanently delete the team and all special permissions assigned to it.

  1. Hover your cursor over the Configuration (gear) icon in the side menu.
  2. Click Teams. Grafana displays the team list.
  3. Click the red X next to the team that you want to delete and then click Delete.