Create a team folder when creating 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: (1) Open Administration and go to Users and access > Teams, (2) Click New team, (3) Enter the team details, (4) Under Team folder, select Auto-create a team folder, (5) 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.
Create a new team folder from Dashboards
To create a new team folder: (1) Click Dashboards in the primary menu, (2) Click New and select New folder, (3) Enter a unique folder name, (4) Select Assign an owner to the folder, (5) In Team dropdown, select the team that should own the folder, (6) 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: (1) Click Dashboards in the primary menu, (2) Open the folder that you want to update, (3) Click Folder actions and select Manage folder owner, (4) Select a team, or clear the current value if you want to remove the owner, (5) Click Save owner. If a folder has a team owner, Grafana displays an Owned by label in the folder header.
My team folders section on Dashboards page
When team folders are enabled, the Dashboards page displays a My team folders section near the top when you belong to teams that own folders. You can expand that section to open the folders owned by your teams.
Team folders in folder picker for saving dashboards
When saving or moving a dashboard, the folder picker shows a Team folders section at the top of the folder tree. Your first team folder will be preselected by default.
Folder nesting depth limit
When nesting folders, you can do so up to four levels deep.
Folder naming restrictions
Folder names cannot include underscores (_) or percentage signs (%), as these interfere with search functionality. Additionally, alerts cannot be placed in folders with slashes (/) in the name, so if you want to place alerts in a folder, do not use slashes in the folder name.
Dashboard deletion and restoration timeline
Deleted dashboards are stored in the deletion history for up to 12 months and can be restored if needed. After 12 months, Grafana permanently removes them.
Dashboard restoration access permissions
You can restore dashboards that you deleted. Users with admin rights can restore any dashboard.
Dashboard restoration limitations
Dashboard restoration has three key limitations: (1) Dashboard-specific permissions are not restored, and custom permissions must be manually reconfigured after restoration; (2) Restored dashboards inherit the permissions of the target folder selected during restoration; (3) The dashboard's version history is not preserved, and the dashboard starts with version 1 after restoration with all previous versions lost.
Dashboard restoration folder preselection rules
When restoring dashboards, the target folder is preselected according to these rules: (1) If restoring a single dashboard and its original folder still exists, that folder is preselected; (2) If restoring multiple dashboards from the same folder, that folder is preselected; (3) If restoring dashboards from different folders, you must choose one target folder for all of them; (4) If the original folder no longer exists, you must select a new target folder.
Folder permissions inheritance
Dashboards in a folder inherit any permissions that have been assigned to the folder. Permissions can be assigned to organization roles, teams, and users.
Generative AI dashboard features
Grafana supports generative AI features for dashboards: (1) Generate panel and dashboard titles and descriptions based on data, useful for quick visualization; (2) Generate dashboard save changes summary when saving a dashboard, useful for tracking history. These features require installing and configuring Grafana's Large Language Model (LLM) app plugin and display as an '✨ Auto generate' option next to Title and Description fields.
Filter and Group by automatically queries data source for available dimensions
The Filter and Group by option automatically queries your data source for available dimensions and lets users add or remove filters and group by dimensions on the dashboard dynamically. Instead of creating a variable for each dimension by which you want to filter, it allows you to quickly apply filters dashboard-wide.
Group by function splits aggregated results by selected dimensions
The group by function allows you to group data by keys, letting you split it up. This function is typically used with aggregation queries, such as sum(your_metric_here), to split aggregated results by the selected dimensions.
Filter and Group by automatically adds filters to all queries
The filter and group by feature lets you add label/value filter pairs that are automatically added to all queries that use the specified data source. Unlike variables, you don't use these filters in queries. Instead, you use them to write filters for existing queries.
Data sources supporting filters and group by
The following data sources support filters. Data sources with an asterisk also support the group by function: Prometheus*, Loki*, InfluxDB, Elasticsearch, OpenSearch, and the special Dashboard data source.
How to add Filter and Group by controls to a dashboard
To add filters and group by controls: 1. Navigate to the dashboard you want to update. 2. Click Edit. 3. Click the Add new element icon (blue plus sign). 4. Click Filter and Group by. 5. Enter a Name for the filter. 6. (Optional) In the Label field, enter the display name for the filter drop-down list. If you don't enter a display name, then the drop-down list label is the filter name. 7. (Optional) In the Description field, enter a description of the filter. The description appears as an info icon tooltip next to the filter name on the dashboard. Descriptions support links using Markdown-style links ([link text](https://example.com)) or bare URLs (https://example.com). Only http and https URLs are rendered as clickable links. 8. Choose a Display option: Above dashboard (default), Above dashboard label hidden, Controls menu, or Hidden. 9. Under the Filter options section, set the following options: Data source (required, select target data source or click Open advanced data source picker), Default filters (optional, set default key/value pair indicated with information icon), Enable group by (optional, only appears for Prometheus or Loki data sources), Default group by (optional, set default key for dashboard indicated with information icon), Use static key dimensions (optional, provide filter dimensions as CSV), Allow custom values (optional, allow dashboard users to add custom values). 10. Click Save. 11. Enter an optional description of your dashboard changes, and then click Save. 12. Click Exit edit.
Filter and Group by Display options
Display options for filters include: Above dashboard (The filter drop-down list displays above the dashboard with the filter Name or Label value. This is the default.), Above dashboard, label hidden (The filter drop-down list displays above the dashboard, but without showing the name of the filter.), Controls menu (The filter is displayed in the dashboard controls menu instead of above the dashboard. The dashboard controls menu appears as a button in the dashboard toolbar.), Hidden (No filter drop-down list is displayed on the dashboard.)
Filter options configuration table
Filter options configuration has the following fields: Data source (Select a target data source in the drop-down list. You can also click Open advanced data source picker to see more options, including adding a data source for Admins only.), Default filters (Set a default key/value pair. Optional. In the dashboard filter control, the default value is indicated with an information icon.), Enable group by (This option only appears if you selected a Prometheus or Loki data source. Toggle the switch on to enable data grouping.), Default group by (Set a default key for the dashboard. Optional. In the dashboard filter control, the default value is indicated with an information icon.), Use static key dimensions (To provide the filter dimensions as comma-separated values (CSV), toggle the switch on, and then enter the values in the space provided. Optional.), Allow custom values (Toggle the switch on to allow dashboard users to add custom values to the filter and group by lists. Optional.)
Filters overview shows all active filters and group by dimensions
To see all active filters and group by dimensions across the dashboard all at once, click the Filters overview icon (filter) in the toolbar to open an overview. The overview lets you search for specific keys and adjust them without scrolling through the dashboard controls.
Cross-filtering from visualizations
In some visualizations, you can apply filters directly from the visualization. Click on a series in the panel and then click Filter on this value or Filter out this value. This filters by the labels found on that series.
Enable cross-filtering with Filterable field override
To enable cross-filtering functionality in a visualization, you need to add an override for every field by which you want to filter. In the override: select a field name and enable the Filterable switch. Alternatively, you can do this programmatically by returning the data frame with the appropriate filterable property on the desired fields.
Visualizations supporting cross-filtering
Cross-filtering is supported for the following visualizations: Bar chart (Requires Group by: no), Histogram (Requires Group by: yes), State timeline (Requires Group by: yes), Status history (Requires Group by: yes), Table (Requires Group by: no), Time series (Requires Group by: yes).
Apply cross-filtering from panel data
To apply cross-filtering: 1. To display the filter icons, hover your cursor over the data point with the value for which you want to filter. In table visualizations, hover over the cell value. In bar chart visualizations, hover and click the bar to display the filter button. 2. Click the add filter icon. The filter pair is added, and all panels using the same data source that include that value are filtered by it. If one of the panels in the dashboard using that data source doesn't include that filter value, the panel won't return any data.
Group by selector at panel level
When the Group by switch is toggled on, you can also set a group by dimension from a panel rather than from the dashboard-level control. Hover the cursor over any panel using the data source of the filter to show the Group by selector. The panel-level Group by control only includes keys available in the panel's query, in contrast with the dashboard-level control that includes all available keys for the dashboard. Your selection is applied to all the panels in the dashboard with the same data source.
Filter any data using the Dashboard data source
In cases where a data source doesn't support the use of filters, you can use the Dashboard data source to reference that data, and then filter it in a new panel. This allows you to bypass the limitations of the data source in the source panel.
How to filter data using Dashboard data source
To use filters on data from an unsupported data source: 1. Navigate to the dashboard with the panel with the data you want to filter. 2. Click Edit in top-right corner of the dashboard. 3. Click the Add new element icon and click or drag a panel onto the dashboard. 4. Click Configure visualization. 5. In the Queries tab of the edit panel view, enter Dashboard in the Data source field and select -- Dashboard --. 6. In the query configuration section, make the following selections: Source panel (Choose the panel with the source data), Data (Select All Data to use the data of the panel, and not just the annotations. This is the default selection.), Filters (Toggle on the switch to make the data from the referenced panel filterable). Note: If you're referencing multiple panels in a dashboard with the Dashboard data source, you can only use one of those source panels at a time for filtering. 7. Configure any other needed options for the panel. 8. Click Save in the top-right corner. 9. Enter an optional description of your changes and click Save. 10. Click Back and then Exit edit. Now you can filter the data from the source panel by way of the Dashboard data source. Add as many panels as you need.