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.
Dashboard list
Dashboard lists allow you to display dynamic links to other dashboards. The list can be configured to use starred dashboards, recently viewed dashboards, a search query, and dashboard tags.
On each dashboard load, this panel queries the dashboard list, always providing the most up-to-date results.
You can use a dashboard list visualization to display a list of important dashboards that you want to track.
Configure a dashboard list visualization
Once you’ve created a dashboard, the following video shows you how to configure a dashboard list visualization:
With Grafana Play, you can explore and see how it works, learning from practical examples to accelerate your development. This feature can be seen on Dashboard List Visualization.
Panel options
In the Panel options section of the panel editor pane, you set basic options like the panel title and description. You can also configure repeating panels in this section. To learn more, refer to Configure panel options.
Dashboard list options
Use the following options to refine your dashboard list visualization.
Include current time range
Select this option to propagate the time range of the current dashboard to the dashboard links. When you click a link, the linked dashboard opens with the indicated time range already set.
Include current template variable values
Select this option to include template variables currently used as query parameters in a link. When you click the link, any matching templates in the linked dashboard are set to the values from the link. Learn more in Dashboard URL variables.
Starred
Display starred dashboards in alphabetical order.
Recently viewed
Display recently viewed dashboards in alphabetical order.
Search
Display dashboards by search query or tags. You must enter at least one value in Query or Tags. For the Query and Tags fields, variable interpolation is supported. For example, $my_var or ${my_var}.
Show headings
The selected list section (Starred, Recently viewed, Search) is shown as a heading.
Max items
Sets the maximum number of items to list per section. For example, if you leave this at the default value of 10 and select Starred and Recently viewed dashboards, then the panel displays up to 20 total dashboards, 10 in each section.
Search options
These options only apply if the Search option is selected.
Query
Enter the query by which you want to search. Queries are case-insensitive and partial values are accepted.
Folder
Select the dashboard folders that you want to display.
Tags
Enter tags by which you want to search. Note that existing tags don’t appear as you type, and they are case sensitive.
Note: When multiple tags and strings appear, the dashboard list displays those matching all conditions.
Was this page helpful?
Related resources from Grafana Labs
