grafana/docs/sources/reference/dashboard_folders.md

+++ title = "Dashboard Folders" keywords = ["grafana", "dashboard", "dashboard folders", "folder", "folders", "documentation", "guide"] type = "docs" [menu.docs] name = "Folders" parent = "dashboard_features" weight = 3 +++

Dashboard Folders

Folders are a way to organize and group dashboards - very useful if you have a lot of dashboards or multiple teams using the same Grafana instance.

How To Create A Folder

• Create a folder by using the Create Folder link in the side menu.

  

• Use the create Folder button on the Manage Dashboards page.

• When saving a dashboard, you can either choose a folder for the dashboard to be saved in or create a new folder (coming in 5.0 beta)

On the Create Folder page, fill in a unique name for the folder and press Create.

Manage Dashboards

There is a new Manage Dashboards page where you can carry out a variety of tasks:

• create a folder
• create a dashboard
• move dashboards into folders
• delete multiple dashboards
• navigate to a folder page (where you can set permissions for a folder and/or its dashboards)

There is a new option in the Dashboards menu for the Manage Dashboards page:

Here you can manage your dashboards:

Or you can go directly to a Dashboard Folder page via Dashboard Search by clicking on the cog icon:

Dashboard Folder Page

The Dashboard Folder Page is similar to the Manage Dashboards page and is where you can carry out the following tasks:

• allows you to move or delete dashboards in a folder.
• rename a folder (under the Settings tab).
• set permissions on the whole folder.
• set permissions on a single dashboard.

Dashboard Permissions (Not enabled in Grafana 5.0 alpha)

An Access Control List (ACL) model is used for permissions on Dashboard Folders. An individual user can be assigned permissions on a folder or a Team.

The permissions that can be assigned for a folder are: View, Edit, Admin.

The default is that:

• everyone has access to a folder and that their permissions depend on their user role (Viewer, Editor or Admin).
• An Admin or Editor can remove the default access for everyone and can then assign a user or team to a Dashboard Folder.
• Teams make it easier to assign permissions for multiple users to multiple dashboards.

Other Dashboard Folder rules:

• Users with the Admin and Editor role are allowed to create new Dashboard Folders.
• Users with the Viewer role are not allowed to create new Dashboard Folders.
• Editors who are owners and Admins can assign permissions to users or teams for Dashboard Folders.
• Default permissions can be removed except for the Admin permissions (View, Edit).

Limiting Permissions on a Folder

To limit permissions on a folder or dashboard:

1. go to the permissions tab on the Dashboard Folder page
2. remove the default permissions (Everyone with Editor Role / Everyone with Viewer Role)
3. Give a team or user specific permissions. For example: frontend-team can edit and ops-team can view.

Remember that users with the Admin role will always have permission to all folders and dashboards.

Teams (Not enabled in Grafana 5.0 alpha)

Teams is a new concept for Grafana 5.0. A team is a group of users that can be assigned permissions on a dashboard folder or a dashboard.

How Teams Work:

• Admins can create teams.
• No hierarchies. Teams cannot contain teams.
• If a user belongs to multiple teams, their permissions are merged to give them the highest permission possible for a dashboard folder or dashboard.