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

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Administrationbreadcrumb arrow Organization preferences
Enterprise Open source

Organization preferences

Grafana preferences are basic settings. They control the Grafana UI theme, home dashboard, time zone, and so on.

Preferences are sometimes confusing because they can be set at four different levels, listed from highest level to lowest:

  • Server - Affects all users on the Grafana server. Set by a Grafana server admin.
  • Organization - Affects all users in an organization. Set by an Organization admin.
  • Team - Affects all users assigned to a team. Set by an Organization Admin or Team Admin. To learn more about these roles, refer to Teams and permissions.
  • User account - Affects the individual user. Set by the user on their own account.

The lowest level always takes precedence. For example, if a user sets their theme to Light, then their visualization of Grafana displays the light theme. Nothing at any higher level can override that.

If the user is aware of the change and intended it, then that’s great! But if the user is a Server Admin who made the change to their user preferences a long time ago, they might have forgotten they did that. Then, if that Server Admin is trying to change the theme at the server level, they’ll get frustrated as none of their changes have any effect that they can see. (Also, the users on the server might be confused, because they can see the server-level changes!)

Change Grafana name and email

In Grafana, you can change your names and emails associated with groups or accounts in the Settings or Preferences. This topic provides instructions for each task.

Some tasks require certain permissions. For more information about roles, refer to Roles and permissions.

Change organization name

Grafana server administrators and organization administrators can change organization names.

Grafana Server Admin change organization name

Follow these instructions if you are a Grafana Server Admin.

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Organizations.
  4. In the organization list, click the name of the organization that you want to change.
  5. In Name, enter the new organization name.
  6. Click Update.

Organization Admin change organization name

If you are an Organization Admin, follow these steps:

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Default preferences.
  4. In Organization name, enter the new name.
  5. Click Update organization name.

Change team name or email

Organization administrators and team administrators can change team names and email addresses. To change the team name or email, follow these steps:

  1. Click Administration in the left-side menu, Users and access, and select Team.
  2. In the team list, click the name of the team that you want to change.
  3. Click the Settings tab.
  4. In the Team details section, you can edit the following:
    • Name - Edit this field to change the display name associated with the team.
    • Email - Edit this field to change the email address associated with the team.
  5. Click Update.

Change user name or email

To learn how to edit your user information, refer to Edit your profile.

Change Grafana UI theme

In Grafana, you can modify the UI theme configured in the Settings or Preferences. Set the UI theme for the server, an organization, a team, or your personal user account using the instructions in this topic.

Some tasks require certain permissions. For more information about roles, refer to Roles and permissions.

Theme options

The theme affects how Grafana displays graphs, menus, other UI elements.

Default

Default is either the dark theme or the theme selected in a higher level. For example, if an Organization administrator set the Light theme, then that is the default for all the teams in that organization.

Dark

Here is an example of the dark theme.

Dark theme example

Light

Here is an example of the light theme.

Light theme example

Experimental

There are several experimental themes that you can also choose from. To see the color scheme of a theme before selecting it for your organization, click the user icon in the top-right corner of the page and select Change theme. This opens the Change theme drawer, where you can view all themes.

Change server UI theme

As a Grafana server administrator, you can change the default Grafana UI theme for all users who are on the server by setting the default_theme option in the Grafana configuration file.

To see what the current settings are, refer to View server settings.

Change organization UI theme

Organization administrators can change the UI theme for all users in an organization.

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Default preferences.
  4. In the Preferences section, select the UI theme.
  5. Click Save.

Change team UI theme

Organization and team administrators can change the UI theme for all users on a team.

  1. Click Administration in the left-side menu, Users and access, and select Teams.
  2. Click the team for which you want to change the UI theme.
  3. Click the Settings tab.
  4. In the Preferences section, select the UI theme.
  5. Click Save.

Change your personal UI theme

You can change the UI theme for your user account. This setting overrides UI theme settings at higher levels.

  1. Click the user icon in the top right corner of the page and select Profile.
  2. In the Preferences section, select the UI theme.
  3. Click Save.

Change the Grafana default timezone

By default, Grafana uses the timezone in your web browser. However, you can override this setting at the server, organization, team, or individual user level. This topic provides instructions for each task.

Some tasks require certain permissions. For more information about roles, refer to Roles and permissions.

Set server timezone

Grafana server administrators can choose a default timezone for all users on the server by setting the default_timezone option in the Grafana configuration file.

Set organization timezone

Organization administrators can choose a default timezone for their organization.

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Default preferences.
  4. Click to select an option in the Timezone list. Default is either the browser local timezone or the timezone selected at a higher level.
  5. Click Save.

Set team timezone

Organization administrators and team administrators can choose a default timezone for all users on a team.

  1. Click Administration in the left-side menu, Users and access, and select Teams.
  2. Click the team for which you want to change the timezone.
  3. Click the Settings tab.
  4. Click to select an option in the Timezone list. Default is either the browser local timezone or the timezone selected at a higher level.
  5. Click Save.

Set your personal timezone

You can change the timezone for your user account. This setting overrides timezone settings at higher levels.

  1. Click the user icon in the top right corner of the page and select Profile.
  2. Click to select an option in the Timezone list. Default is either the browser local timezone or the timezone selected at a higher level.
  3. Click Save.

Change the default home page

When you sign in to Grafana, you see the Grafana home page. Click the Grafana icon or Home in the breadcrumb to return to it. You can replace it with a dashboard for the server, an organization, a team, or your personal user account. This topic explains how Grafana picks the home page and provides instructions for each task.

Some tasks require certain permissions. For more information about roles, refer to Roles and permissions.

How Grafana picks the home page

Grafana checks these sources in order and uses the first one that’s set:

  1. The Home Dashboard preference. Grafana checks the user level first, then the team level, then the organization level, and uses the first level that has a dashboard set.
  2. The home_page configuration option. Grafana redirects to this path.
  3. The default_home_dashboard_path configuration option. Grafana shows the dashboard from this JSON file.
  4. The Grafana home page.

The Home Dashboard field at every level also offers Grafana home. Select it to ignore the dashboards set at higher levels and show the instance default: home_page, default_home_dashboard_path, or the Grafana home page. For example, if your organization sets a dashboard and you select Grafana home in your profile, you see the instance default instead of the organization’s dashboard. At the organization level, Grafana home and an empty field have the same effect, because the next level up is the server configuration.

Clear the field to inherit the home page from the next level. For example, a user with an empty field gets their team’s dashboard, or the organization’s dashboard if the team hasn’t set one.

Set the home page for the server

Users with the Grafana Server Admin flag on their account or access to the configuration file can set the home page for all users on the server in two ways:

  • home_page in the [users] section redirects users to a path in Grafana, such as an app plugin page.
  • default_home_dashboard_path in the [dashboards] section shows a dashboard from a JSON file.

If you set both, home_page takes precedence. Both settings apply to users who haven’t set a home dashboard preference and to users who select Grafana home. A dashboard set in a user, team, or organization preference overrides both.

Redirect users to a page

Set home_page to a path that matches a frontend route. The path must start with a slash.

ini 
[users]
home_page = /a/my-app/home

[Optional] Convert an existing dashboard into a JSON file

  1. Navigate to the page of the dashboard you want to use as the home dashboard.
  2. Click the Share button at the top right of the screen.
  3. In the Export tab, click Save to file. Grafana converts the dashboard to a JSON file and saves it locally.

Use a JSON file as the home dashboard

  1. Save your JSON file somewhere that Grafana can access it. For example, in the Grafana data folder of Grafana.
  2. Update your configuration file to set the path to the JSON file. Refer to default_home_dashboard_path for more information about modifying the Grafana configuration files.
ini 
[dashboards]
# Path to a custom default home dashboard. If empty, Grafana shows the Grafana home page.
default_home_dashboard_path = data/main-dashboard.json

Replacing public/dashboards/home.json on disk is not supported. If you previously customized home that way, move the file and set default_home_dashboard_path to its path.

Set the home dashboard for your organization

Organization administrators can choose a default home dashboard for their organization. Teams and users inherit it unless they set their own dashboard or select Grafana home.

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Default preferences.
  4. In the Home Dashboard field, search for and select the dashboard that you want to use, or select Grafana home to show the instance default.
  5. Click Save.

Set the home dashboard for your team

Organization administrators and Team Admins can set a default home dashboard for all users on a team. The team’s dashboard overrides the organization’s dashboard for team members who haven’t set their own.

  1. Click Administration in the left-side menu, Users and access, and select Teams.
  2. Click the team for which you want to change the home dashboard.
  3. Click the Settings tab.
  4. In the Home Dashboard field, search for and select the dashboard that you want to use. Select Grafana home to opt the team out of the organization’s dashboard and show the instance default instead.
  5. Click Save.

Set your personal home dashboard

You can choose your own personal home dashboard. This setting overrides the home dashboards set at the team and organization levels.

  1. Click the user icon in the top right corner of the page and select Profile.
  2. In the Home Dashboard field, search for and select the dashboard that you want to use. Select Grafana home to opt out of your team’s or organization’s dashboard and show the instance default instead.
  3. Click Save.

Change Grafana language

Change server language

Grafana server administrators can change the default Grafana UI language for all users on the server by setting the default_language option in the Grafana configuration file.

Change organization language

Organization administrators can change the language for all users in an organization.

  1. Click Administration in the left-side menu.
  2. Click General.
  3. Click Default preferences.
  4. In the Preferences section, select an option in the Language dropdown.
  5. Click Save.

Change team language

Organization and team administrators can set a default language for all users on a team.

  1. Click Administration in the left-side menu, Users and access, and select Teams.
  2. Click the team for which you want to change the language.
  3. Click the Settings tab.
  4. In the Preferences section, select an option in the Language dropdown.
  5. Click Save.

Change your personal language

You can change the language for your user account. This setting overrides language settings at higher levels.

  1. Click the user icon in the top right corner of the page and select Profile.
  2. In the Preferences section, select an option in the Language dropdown.
  3. Click Save.