Manage teams with Grafana Teams on Grafana Labs

Configure Grafana Teams

Mon, 20 Apr 2026 14:56:21 +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).
- The None basic role can’t view any resources by default. Recommended for isolated teams.
- the Viewer role can view all resources by default. 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 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.

When the teamFolders feature toggle is enabled, the New Team page also includes a Auto-create a team folder option. Select Auto-create a team folder if you want Grafana to create a folder owned by that team during setup. For more information, refer to Manage team folders.

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

Tue, 14 Apr 2026 09:48:24 +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 team folders

Tue, 21 Apr 2026 09:42:47 +0000

Manage team folders

Team folders help you associate folders with teams so admins and team members can find the right dashboards, library panels, and alert rules faster. They streamline setup by letting admins create and assign a dedicated folder when creating a team, establishing clear ownership from the start. A team folder is still a regular folder—the team association adds ownership metadata and team-aware navigation, but it doesn’t change or replace folder permission.

Team folders is in public preview.

Before you begin, ensure you have the following:

The teamFolders and foldersAppPlatformAPI feature toggle enabled.
Permission to create root-level folders, or permission to create subfolders in the parent folder you want to use.
Permission to manage folder permissions and read teams if you want to assign or change a folder owner in the UI.

Enable team folders

To enable team folders in Grafana OSS or Grafana Enterprise, the teamFolders and foldersAppPlatformAPI feature toggle must be enabled.

For more information about feature toggles, refer to Configure feature toggles.

Create a team folder when you create a team

When team folders are enabled, the New team page includes an option to create a team folder automatically.

To create a team and its folder, complete the following steps:

Open Administration and go to Users and access > Teams.
Click New team.
Enter the team details.
Under Team folder, select Auto-create a team folder.
Click Create.

Grafana creates a folder with the same name as the team and assigns that team as the folder owner. After the folder is created, review the folder permissions and update them if needed.

For more information about creating teams, refer to Configure Grafana Teams.

Create or assign a team folder from Dashboards

You can create a new folder for a team or assign ownership to an existing folder.

Create a new team folder

To create a new team folder, complete the following steps:

Click Dashboards in the primary menu.
Click New and select New folder.
Enter a unique folder name.
Select Assign an owner to the folder.
In Team dropdown, select the team that should own the folder.
Click Create.

Grafana creates a regular folder and stores the selected team as the folder owner.

Assign or change the owner of an existing folder

To assign or change the owner of an existing folder, complete the following steps:

Click Dashboards in the primary menu.
Open the folder that you want to update.
Click Folder actions and select Manage folder owner.
Select a team, or clear the current value if you want to remove the owner.
Click Save owner.

If a folder has a team owner, Grafana displays an Owned by label in the folder header.

Find team folders

When team folders are enabled, Grafana surfaces them in the browse dashboards page and in team details.

Browse dashboards

The Dashboards page displays a My team folders section near the top when you belong to teams that own folders. Expand that section to open the folders owned by your teams.

Save or move dashboards

When you are saving or moving dashboard the folder picker shows a Team folders section at the top of the folder tree. Your first teams folder will be preselected by default.

Review folders owned by a team

Each team page includes a Folders tab that lists all the folders owned by that team.

Manage access for team folders

Folder ownership does not replace folder permissions. Team folders use the same permission model as any other folder.

If team members need access to the folder, configure folder permissions for the team or for the users, roles, or service accounts that should use it. For more information, refer to Manage dashboard permissions.

Limitations

Team folders currently have the following limitations:

You can select only one team owner per folder.
You can’t assign or change a team owner for repository-managed folders.

Next steps

Refer to Manage dashboards for the rest of the dashboards management workflow.
Refer to Manage dashboard permissions to control access to team folders.