--- title: Value mappings options comments: | This file is used in the following visualizations: bar chart, bar gauge, candlestick, canvas, gauge, geomap, histogram, pie chart, stat, state timeline, status history, table, time series, trend --- Value mapping is a technique you can use to change how data appears in a visualization. For each value mapping, set the following options: - **Condition** - Choose what's mapped to the display text and (optionally) color: - **Value** - Specific values - **Range** - Numerical ranges - **Regex** - Regular expressions - **Special** - Special values like `Null`, `NaN` (not a number), or boolean values like `true` and `false` - **Display text** - **Color** (Optional) - **Icon** (Canvas only) To learn more, refer to [Configure value mappings](https://grafana.com/docs/grafana/<GRAFANA_VERSION>/panels-visualizations/configure-value-mappings/).