Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

DocumentationGrafana documentationAdministrationManage users and permissionsManage teams

Manage teams

A team is a group of users within an organization that have common dashboard and data source permission needs. For example, instead of assigning five users access to the same dashboard, you can create a team that consists of those users and assign dashboard permissions to the team. A user can belong to multiple teams.

A user can be a Member or an Administrator for a given team. Members of a team inherit permissions from the team, but they cannot edit the team itself. Team Administrators can add members to a team and update its settings, such as the team name, team member’s team roles, UI preferences, and home dashboard.

For more information about teams, refer to Teams and permissions.

Create a team

A team is a group of users within an organization that have common dashboard and data source permission needs. Use teams to help make user-permission management more efficient.

A user can belong to multiple teams.

Before you begin

• Ensure that you have either organization administrator permissions or team administrator permissions
• Make a plan for which users belong to which teams and the permissions team members receive

To create a team:

1. Sign in to Grafana as an organization administrator or team administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.
3. Click New Team.
4. Complete the fields and click Create.
5. Click Add member.
6. In the Add team member field, locate and select a user.
7. Click Add to team.

Add a team member

Add a team member to an existing team whenever you want to provide access to team dashboards and folders to another user.

Before you begin

• Ensure that you have organization administrator permissions
• Create a team.

To add a team member:

1. Sign in to Grafana as an organization administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.
3. Click the name of the team to which you want to add members, and click Add member.
4. In the Add team member field, locate and select a user.
5. Click Add to team.

Grant team member permissions

Complete this task when you want to add or modify team member permissions.

Before you begin

• Ensure that you have either organization administrator permissions or team administrator permissions

To grant team member permissions:

1. Sign in to Grafana as an organization administrator or a team administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.
3. Click the name of the team for which you want to add or modify team member 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.

Remove a team member

You can remove a team member when you no longer want to apply team permissions to the user.

Before you begin

• Ensure that you have either organization administrator permissions or team administrator permissions

To remove a team member:

1. Sign in to Grafana as an organization administrator or team administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.
3. Click a team from which you want to remove a user.
4. Click the X next to the name of the user.
5. Click Delete.

Delete a team

Delete a team when you no longer need it. This action permanently deletes the team and removes all team permissions from dashboards and folders.

Before you begin

• Ensure that you have organization administrator permissions

To delete a team:

1. Sign in to Grafana as an organization administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.
3. Click the X next to the name of the team.
4. Click Delete.

View a list of teams

See the complete list of teams in your Grafana organization.

Before you begin

• Ensure that you have either organization administrator permissions or team administrator permissions

To view a list of teams:

1. Sign in to Grafana as an organization administrator or a team administrator.
2. Hover your cursor over the Configuration (gear) icon in the side menu and click Teams.

The role you use to sign in to Grafana determines how you see team lists.

Organization administrator view

The following example shows a list as it appears to an organization administrator.

Team administrator view

The following example shows a list as it appears to a team administrator.