Format data using value mapping on Grafana Labs

About value mapping

Sat, 04 Apr 2026 12:26:57 +0000

About value mapping

Value mapping allows you to replace values or ranges in your visualizations with words or emojis.

Values mapped via value mappings will skip the unit formatting. This means that a text value mapped to a numerical value will not be formatted using the configured unit.

If value mappings are present in a panel, then Grafana displays a summary in the side pane of the panel editor.

Note: The new value mappings are not compatible with some visualizations, such as Graph (old), Text, and Heatmap.

Types of value mappings

Grafana supports the following value mappings:

Value maps text values to a color or different display text. For example, if a value is 10, I want Grafana to display Perfection! rather than the number.
Range maps numerical ranges to a display text and color. For example, if a value is within a certain range, I want Grafana to display Low or High rather than the number.
Regex maps regular expressions to replacement text and a color. For example, if a value is ‘www.example.com’, I want Grafana to display just www, truncating the domain.
Special maps special values like Null, NaN (not a number), and boolean values like true and false to a display text and color. For example, if Grafana encounters a null, I want Grafana to display N/A.

You can also use the dots on the left as a “handle” to drag and reorder value mappings in the list.

Time series example

Here’s an example showing a Time series visualization with value mappings. Value mapping colors are not applied to this visualization, but the display text is shown on the axis.

Stat example

Here’s an example showing a Stat visualization with value mappings. You might want to hide the sparkline so it doesn’t interfere with the values. Value mapping text colors are applied.

Bar gauge example

Here’s an example showing a Bar gauge visualization with value mappings. The value mapping colors are applied to the text but not the gauges.

Table example

Here’s an example showing a Table visualization with value mappings. If you want value mapping colors displayed on the table, then set the cell display mode to Color text or Color background.

Map a value

Sat, 04 Apr 2026 12:26:57 +0000

Map a value

Map a value when you want to format a single value.

Before you begin

Add a panel to a dashboard.

To map a value:

Open a panel for which you want to map a value.
In panel display options, locate the Value mappings section and click Add value mappings.
Click Add a new mapping and then select Value.
Enter the value for Grafana to match.
(Optional) Enter display text.
(Optional) Set the color.
Click Update to save the value mapping.

Map a range

Sat, 04 Apr 2026 12:26:57 +0000

Map a range

Map a range of values when you want to format multiple, continuous values.

Before you begin

Add a panel to a dashboard.

To map a range:

Edit the panel for which you want to map a range of values.
In panel display options, in the Value mappings section, click Add value mappings.
Click Add a new mapping and then select Range.
Enter the beginning and ending values in the range for Grafana to match.
(Optional) Enter display text.
(Optional) Set the color.
Click Update to save the value mapping.

Map a regular expression

Sat, 04 Apr 2026 12:26:57 +0000

Map a regular expression

Map a regular expression when you want to format the text and color of a regular expression value.

Before you begin

Add a panel to a dashboard.

To map a regular expression:

Edit the panel for which you want to map a regular expression.
In the panel display options, in the Value mappings section, click Add value mappings.
Click Add a new mapping and then select Regex.
Enter the regular expression pattern for Grafana to match.
(Optional) Enter display text.
(Optional) Set the color.
Click Update to save the value mapping.

Map a special value

Sat, 04 Apr 2026 12:26:57 +0000

Map a special value

Map a special value when you want to format uncommon, boolean, or empty values.

Before you begin

Add a panel to a dashboard.

To map a special value:

Edit the panel for which you want to map a special value.
In panel display options, locate the Value mappings section and click Add value mappings.
Click Add a new mapping and then select Special.
Select the special value for Grafana to match. Options include:
- Null
- NaN (Not a Number)
- Null + NaN
- True
- False
- Empty
(Optional) Enter display text.
(Optional) Set the color.
Click Update to save the value mapping.

Edit a value mapping

Sat, 04 Apr 2026 12:26:57 +0000

Edit a value mapping

You can change a value mapping at any time.

Before you begin

Add a panel to a dashboard.
Ensure you have an existing value mapping to edit.

To edit a value mapping:

Edit the panel that contains the value mapping you want to edit.
In the panel display options, in the Value mappings section, click Edit value mappings.
Make the changes and click Update.