Configure Grafana Teams

Fri, 03 Apr 2026 19:43:06 +0000

Configure Grafana Teams

This topic describes how to set up and configure Grafana Teams.

For a tutorial on working with Teams, refer to Create users and teams.

Before you begin

Before you begin creating and working with Grafana Teams:

Ensure that you have either the Organization Administrator role or team administrator permissions. Refer to Organization roles and RBAC permissions, actions, and scopes for a list of Grafana roles and role-based access control actions.
Decide which users belong to which teams and what permissions team members receive.
Configure the default basic role for users to join Grafana. This role applies to users where no role is set by the identity provider (IDP).
- No basic role - by default can’t view any resources. Recommended for isolated teams.
- Viewer role - by default can view all resources. Recommended for collaborative teams.
Ensure team sync is turned on if you plan to manage team members through team sync. Refer to Configure Team Sync for a list of providers and instructions on how to turn on team sync for each provider.

Note
Grafana Organizations do not exist in Grafana Cloud. Grafana Cloud uses the term organization to refer to accounts in grafana.com, or GCOM. In Grafana Enterprise and OSS, Teams belong to Grafana Organizations. Refer to About organizations for more information.

Create a Grafana Team

A team is a group of users within a Grafana instance that have common permissions needs. Teams to help make user-permission management more efficient. A user can belong to multiple Teams. Grafana Teams includes common access to the following:

dashboards
data sources
folders
alerts
reports
cloud access policies
annotations
playlists

To create a Team, complete the following steps:

Sign in to Grafana as an org administrator or team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.
Click New Team.
Fill in each field and click Create.
Click Save. You can now add a Team member.

Add a Team member

Note

In Grafana Enterprise or Grafana Cloud with RBAC enforcement enabled, adding or viewing team members requires the org.users:read permission, which is typically granted only to Organization Administrators.

In Grafana OSS (or unlicensed), team administrators can search for and add any user in the organization without requiring additional permission.

Add a member to a new Team or add a team member to an existing Team when you want to provide access to team dashboards and folders to another user.

To add a team member, complete the following steps:

Sign in to Grafana as an org administrator or team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.
Click the name of the Team to which you want to add members, and click + Add member.
Search for and select a user.
Choose whether to add the user as a Team Member or Admin.
Click Save.

Grant or change Team member permissions

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

To grant team member permissions:

Sign in to Grafana as an org administrator or team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.
Click the pencil next to the name of the Team for which you want to add or modify team member permissions.
In the team member list, locate the user that you want to change. You can use the search field to filter the list if necessary.
Under the Permission column, select the new permission level.

Add roles to a Grafana Team

You can add or delete roles from a specified team.

To add a role, complete the following steps:

Sign in to Grafana as an org administrator or team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.
Select the Team and click under the Role column. Select from a list of current fixed or plugin roles or clear all roles and start over. As you hover over each role a list of permissions appears to the right. You can clear any permission for additional fine-grained control.
Click Update to add the new role or roles.

To delete a role, remove the check next to the role name and click Update.

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. This task requires that you have Organization Administrator permissions.

Sign in to Grafana as an org administrator or team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.
Click the red X on the right side of the name of the team.
Click Delete.

Administer Grafana Teams

Fri, 03 Apr 2026 19:43:06 +0000

Administer Grafana Teams

This topic describes how to administer Grafana Teams.

View a list of Teams

See the complete list of teams in your Grafana organization.

To view a list of teams:

Sign in to Grafana as an organization administrator or a team administrator.
Click the arrow next to Administration in the left-side menu, click Users and access, and select Teams.

The role you use to sign in to Grafana determines how you see Teams 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.

Teams best practices

Grafana recommends you use Teams to organize and manage access to Grafana’s core resources, such as dashboards and alerts. Teams is an easy organizational tool to manage, and allows flexible sharing between teams.

Grafana recommends that you use Instances or Stacks to separate Teams if you want true isolation, to ensure that no information leaks between Teams. You can synchronize some resources between instances using provisioning.

Secure Grafana Teams

The most important thing to consider for securing Teams is to only grant team administrator rights to the users you trust to administer the Team.

Manage teams with Grafana Teams on Grafana Labs

Configure Grafana Teams

Configure Grafana Teams

Before you begin

Create a Grafana Team

Add a Team member

Grant or change Team member permissions

Add roles to a Grafana Team

Delete a team

Administer Grafana Teams

Administer Grafana Teams

View a list of Teams

Organization administrator view

Team administrator view

Teams best practices

Secure Grafana Teams