Menu

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.

Enterprise Open source

Manage organizations as a Server Admin

This topic explains organization management tasks performed by Grafana Server Admins.

In order to perform any of these tasks, you must be logged in to Grafana on an account with Grafana Server Admin permissions. For more information about Grafana Admin permissions, refer to Grafana Server Admin role

Note: The Grafana Server Admin role does not exist in Grafana Cloud. Grafana Cloud users cannot perform tasks listed in this section.

View organization list

See a complete list of organizations set up on your Grafana server.

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.

Grafana displays all organizations set up on the server, listed in alphabetical order by organization name. The following information is displayed:

  • Id - The ID number of the organization.
  • Name - The name of the organization.

Server Admin organization list

Create organization

Add an organization to your Grafana server.

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click + New org.
  4. Enter the name of the new organization and then click Create.

Two things happen:

  • Grafana creates a new organization with you as the sole member and Admin.
  • Grafana opens the new organization Preferences tab.

You can now add users or perform other Organization Admin tasks.

Delete organization

Permanently remove an organization from your Grafana server.

Warning: Deleting the organization also deletes all teams and dashboards for this organization.

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click the red X next to the organization that you want to remove.
  4. Click Delete.

Edit an organization

Grafana Server Admins can perform some organization management tasks that are almost identical to Organization Admin tasks, just accessed from a different menu path.

Server admin Edit Organization

View organization members and roles

See which user accounts are assigned to the organization and their assigned roles.

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click the name of the organization for which you want to view members.
  4. Scroll down to the Organization Users section. User accounts are displayed in alphabetical order.

Change organization name

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click the name of the organization that you want to edit.
  4. In the Name field, type the new organization name.
  5. Click Update.

Change organization member role

Change the organization role assigned to a user account that is assigned to the organization you are editing.

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click the name of the organization that you want to edit.
  4. In the Organization Users section, locate the user account that you want to change the role of.
  5. In the Role field, select the new role that you want to assign.

Remove a user from an organization

  1. Hover your cursor over the Server Admin (shield) icon until a menu appears.
  2. Click Orgs.
  3. Click the name of the organization that you want to edit.
  4. In the Organization Users section, locate the user account that you want to change the role of.
  5. Click the red X next to the user account listing and then click Delete.