跳转到主要内容

Configure panel options

There are settings common to all visualizations, which you set in the Panel options section of the panel editor pane. The following sections describe these options as well as how to set them.

Panel options

Set the following options to provide basic information about a panel and define basic display elements:

Option Description
Title Text entered in this field appears at the top of your panel in the panel editor and in the dashboard. You can use variables you have defined or built-in variables.
Description Add a description to a panel to share with users any important information about it, such as its purpose. Text entered in this field appears in a tooltip in the upper-left corner of the panel. Conversely, toggle on the As subtitle switch to display the description just below the panel title instead. You can use variables you have defined or dashboard-scoped built-in variables (such as $__from, $__to, $__dashboard, $__org, and $__user). Query-scoped built-in variables (such as $__interval and $__interval_ms) are not available in this field.
Transparent background Toggle this switch on and off to control whether or not the panel has the same background color as the dashboard.
Panel links Add links to the panel to create shortcuts to other dashboards, panels, and external websites. Access panel links by clicking the icon next to the panel title.
Repeat options Set whether to repeat the panel for each value in the selected variable. For more information, refer to Configure repeating panels.
Show/hide rules Set whether to show or hide panels based on various rules. For more information, refer to Show/hide rules.

You can use generative AI to populate the Title and Description fields with the Grafana LLM plugin, which is currently in public preview. To enable this, refer to Set up generative AI features for dashboards.

Description field formatting

Grafana renders the Description field as GitHub Flavored Markdown (GFM). You can use common Markdown and GFM features, including:

  • Emphasis: **bold**, _italic_, and ~~strikethrough~~
  • Structure: headings, paragraphs, blockquotes, horizontal rules, bulleted and numbered lists
  • Code: `inline code` and fenced code blocks
  • Links and media: [link text](https://example.com) and images ![alt](https://example.com/image.png)
  • Tables: GFM-style pipe tables

The description appears in a tooltip, so short copy and basic formatting work best. To break text into separate paragraphs, use an empty line between them, or use a list.

Grafana sanitizes the rendered HTML to reduce security risk and strips out or restricts arbitrary HTML, scripts, and many embedded elements, similar to Markdown in the Text visualization.

Configure repeating panels

You can configure Grafana to dynamically add panels to a dashboard. A dynamic panel is a panel that the system creates based on the value of a multi-value variable. Variables dynamically change your queries across all panels in a dashboard.

To see an example of repeating panels, refer to this dashboard with repeating panels.

For information about repeating rows and tabs, refer to Configure repeat options.

Before you begin:

  • Ensure that the query includes a multi-value variable.

To configure repeating panels, follow these steps:

{{< docs/list >}}

  1. Go to the dashboard you want to update and navigate to the panel you want to repeat.

    If the dashboard is large, open the Content outline and use it to navigate to the part of the dashboard you want to update.

  2. Click Edit.

  3. Click the panel to open the sidebar.

{{% shared-snippet path="/docs/grafana/latest/visualizations/dashboards/build-dashboards/create-dashboard/_index.md" id="configure-repeat" %}}

  1. To propagate changes to all panels, reload the dashboard.

{{< /docs/list >}}

You can stop a panel from repeating by selecting Disable repeating in the Repeat by variable drop-down list.

Limitations of repeating panels

Panels generated by the repeat feature have the following limitations:

  • Generated panels can't be edited: Only the source panel is editable and changes you make in the source panel editor apply to all generated copies.
  • Layout changes don't persist: Each time the dashboard loads or refreshes, Grafana regenerates repeated panels from the source panel. Any layout changes you make to the generated copies are overwritten on reload.
  • You can't mix repeated panels: You can't mix repeated panels with other panels on the same row when using the horizontal repeat direction.

If you need each panel to have a unique, stable layout position or individual settings, disable the repeat option and create separate panels manually instead.

Show/hide rules

You can configure panels to be shown or hidden based on rules. For example, you can set a panel to be hidden if there's no data returned by a query or to only be shown if a specific variable value is present.

{{% shared-snippet path="/docs/grafana/latest/visualizations/dashboards/build-dashboards/create-dashboard/_index.md" id="show-hide-1" %}}

Query result rule

{{% shared-snippet path="/docs/grafana/latest/visualizations/dashboards/build-dashboards/create-dashboard/_index.md" id="show-hide-2" %}}

Template variable rule

Show or hide a panel dynamically based on a variable value. You can select any variable that's configured for the dashboard and choose from the following operators for maximum flexibility:

  • Equals
  • Not equals
  • Matches (regular expression values)
  • Not matches (regular expression values)

You can add more variables if you need to without leaving the dashboard.

Time range less than rule

Show or hide a panel if the dashboard time range is shorter than the selected time range. This ensures that as you change the time range of the dashboard, you only see data relevant to that time period.

{{% shared-snippet path="/docs/grafana/latest/visualizations/dashboards/build-dashboards/create-dashboard/_index.md" id="show-hide-3" %}}

Configure show/hide rules

To configure a show/hide rule, follow these steps:

  1. Navigate to the dashboard you want to update.

  2. Click Edit.

  3. Click the panel you want to update to open the sidebar, or click the Dashboard options icon to open it.

    If the dashboard is large, open the Content outline and use it to navigate to the part of the dashboard you want to update.

  4. Expand the Show / hide rules section.

  5. Select Show or Hide to set whether the panel is shown or hidden based on the rules outcome.

  6. Click + Add rule.

  7. Select a rule type:

    • Query result: Show or hide a panel based on query results. Choose from Has data and No data.
    • Template variable: Show or hide the panel dynamically based on the variable value. Select a variable and operator, and enter a value.
    • Time range less than: Show or hide the panel if the dashboard time range is shorter than the selected time range. Select a time range from 5 minutes to 5 years.
  8. If you've configured multiple rules, the Match rules option displays. Select one of the following:

    • Match all: The panel is shown or hidden only if all the rules are matched.
    • Match any: The panel is shown or hidden if any of the rules are matched.
  9. When you've finished setting rules, save the dashboard.

  10. (Optional) Enter a description of the changes you've made.

  11. Click Save again.

  12. Click Exit edit

Hidden panels aren't visible when the dashboard is in view mode. In edit mode, hidden dashboard panels are displayed with an icon or overlay indicating this.