---
title: "Text | Grafana documentation"
description: "Configure options for Grafana's text visualization"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Text

Text visualizations let you include text or HTML in your dashboards. This can be used to add contextual information and descriptions or embed complex HTML.

For example, if you want to display important links on your dashboard, you can use a text visualization to add these links:

[](/media/docs/grafana/panels-visualizations/screenshot-text-visualization-v11.6.png)

Give it a try using Grafana Play

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 [Text Panel](https://play.grafana.org/d/adl33bxy1ih34b/).

[Try it](https://play.grafana.org/d/adl33bxy1ih34b/)

Use a text visualization when you need to:

- Add important links or useful annotations.
- Provide instructions or guidance on how to interpret different panels, configure settings, or take specific actions based on the displayed data.
- Announce any scheduled maintenance or downtime that might impact your dashboards.

## Configuration options

The following section describes the configuration options available in the panel editor pane for this visualization. These options are, as much as possible, ordered as they appear in Grafana.

### Panel options

In the **Panel options** section of the panel editor pane, set options like the panel title, description, and show/hide rules. To learn more, refer to [Configure panel options](/docs/grafana/latest/visualizations/panels-visualizations/configure-panel-options/).

Expand table

| 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](/docs/grafana/latest/visualizations/dashboards/variables/) or [global variables](/docs/grafana/latest/visualizations/dashboards/variables/add-template-variables/#global-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 **Use as subtitle** switch to display the description just below the panel title instead. You can use [variables you have defined](/docs/grafana/latest/visualizations/dashboards/variables/) or dashboard-scoped [global variables](/docs/grafana/latest/visualizations/dashboards/variables/add-template-variables/#global-variables) (such as `$__from`, `$__to`, `$__dashboard`, `$__org`, and `$__user`). Query-scoped global 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](/docs/grafana/latest/visualizations/dashboards/build-dashboards/manage-dashboard-links/#panel-links) 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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Show/hide rules        | Set whether to show or hide panels based on various rules.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

### Text options

Use the following options to refine your text visualization.

Expand table

OptionDescription

ModeDetermines how embedded content appears. Choose from:

- **Markdown** - Formats the content as [markdown](https://en.wikipedia.org/wiki/Markdown).
- **HTML** - Renders the content as [sanitized](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/text/sanitize.ts) HTML. If you require more direct control over the output, you can set the [disable\_sanitize\_html](/docs/grafana/latest/setup-grafana/configure-grafana/#disable_sanitize_html) flag which enables you to directly enter HTML.
- **Code** - Renders content inside a read-only code editor. [Variables](/docs/grafana/latest/dashboards/variables/variable-syntax/) in the content are expanded for display.

To allow embedding of iframes and other websites, you need set `allow_embedding = true` in your Grafana `config.ini` or environment variables, depending on your deployment.

ContentEnter the text to display. The content supports Markdown, HTML, or code, depending on **Mode**. Dashboard variables are interpolated in the content.

LanguageWhen you choose **Code** as your text mode, select an appropriate language to apply syntax highlighting to the embedded text. Choose from JSON, YAML, XML, TypeScript, SQL, Go, Markdown, HTML, or Plain text. The default is Plain text.

Show line numbersDisplays line numbers in the panel preview when you choose **Code** as your text mode.

Show mini mapDisplays a small outline of the embedded text in the panel preview when you choose **Code** as your text mode.
