Field options and overrides on Grafana Labs

Configure all fields

Fri, 07 Mar 2025 11:34:44 +0100

Configure all fields

To change how all fields display data, you can change an option in the Field tab. In the Overrides tab, you can then override the field options for specific fields.

For example, you could change the number of decimal places shown in all fields by changing the Decimals option. For more information about options, refer to:

Standard field options, apply to all visualizations that allow transformations.
Table field options, which only apply to table panel visualizations.

Change a field option

You can change as many options as you want to.

Navigate to the panel you want to edit, click the panel title, and then click Edit.
Click the Field tab.
Find the option you want to change. You can define:
- Standard field options, which apply to all panel visualizations that allow transformations.
- Table field options, which only apply to table panel visualizations.
Add options by adding values in the fields. To return options to default values, delete the white text in the fields.
When finished, click Save to save all panel edits to the dashboard.

Field option example

Let’s assume that our result set is a data frame that consists of two fields: time and temperature.

time	temperature
2020-01-02 03:04:00	45.0
2020-01-02 03:05:00	47.0
2020-01-02 03:06:00	48.0

Each field (column) of this structure can have field options applied that alter the way its values are displayed. This means that you can, for example, set the Unit to Temperature > Celsius, resulting in the following table:

time	temperature
2020-01-02 03:04:00	45.0 °C
2020-01-02 03:05:00	47.0 °C
2020-01-02 03:06:00	48.0 °C

While we’re at it, the decimal place doesn’t add anything to this display. You can change the Decimals from auto to zero (0), resulting in the following table:

time	temperature
2020-01-02 03:04:00	45 °C
2020-01-02 03:05:00	47 °C
2020-01-02 03:06:00	48 °C

Configure specific fields

Fri, 07 Mar 2025 11:34:44 +0100

Configure specific fields

Overrides allow you to change the settings for one or more fields. Field options for overrides are exactly the same as the field options available in a particular visualization. The only difference is that you choose which fields to apply them to.

For example, you could change the number of decimal places shown in all numeric fields or columns by changing the Decimals option for Fields with type that matches Numeric. For more information about options, refer to:

Standard field options, which apply to all panel visualizations that allow transformations.
Table field options, which only apply to table panel visualizations.

Add a field override

You can override as many field options as you want to.

Navigate to the panel you want to edit, click the panel title, and then click Edit.
Click the Overrides tab.
Click Add an override for.
Select which fields an override rule will be applied to:
- Fields with name - Select a field from the list of all available fields. Properties you add to a rule with this selector are only applied to this single field.
- Fields with name matching regex - Specify fields to override with a regular expression. Properties you add to a rule with this selector are applied to all fields where the field name match the regex.
- Fields with type - Select fields by type, such as string, numeric, and so on. Properties you add to a rule with this selector are applied to all fields that match the selected type.
- Fields returned by query - Select all fields returned by a specific query, such as A, B, or C. Properties you add to a rule with this selector are applied to all fields returned by the selected query.
Click Add override property.
Select the field option that you want to apply.
- Standard field options, which apply to all panel visualizations that allow transformations.
- Table field options, which only apply to table panel visualizations.
Enter options by adding values in the fields. To return options to default values, delete the white text in the fields.
Continue to add overrides to this field by clicking Add override property, or you can click Add override and select a different field to add overrides to.
When finished, click Save to save all panel edits to the dashboard.

Delete a field override

Navigate to the Overrides tab that contains the override that you want to delete.
Click the trash can icon next to the override.

Field override example

Let’s assume that our result set is a data frame that consists of four fields: time, high temp, low temp, and humidity.

time	high temp	low temp	humidity
2020-01-02 03:04:00	45.0	30.0	67
2020-01-02 03:05:00	47.0	34.0	68
2020-01-02 03:06:00	48.0	31.0	68

Let’s apply the field options from the field option example to apply the Celsius unit and get rid of the decimal place. This results in the following table:

time	high temp	low temp	humidity
2020-01-02 03:04:00	45 °C	30 °C	67 °C
2020-01-02 03:05:00	47 °C	34 °C	68 °C
2020-01-02 03:06:00	48 °C	31 °C	68 °C

The temperature fields look good, but the humidity is nonsensical. We can fix this by applying a field option override to the humidity field and change the unit to Misc > percent (0-100). This results in a table that makes a lot more sense:

time	high temp	low temp	humidity
2020-01-02 03:04:00	45 °C	30 °C	67%
2020-01-02 03:05:00	47 °C	34 °C	68%
2020-01-02 03:06:00	48 °C	31 °C	68%

Standard field options

Fri, 07 Mar 2025 11:34:44 +0100

Standard field options

This section explains all available field options. They are listed in alphabetical order.

You can apply standard field options to most built-in Grafana panels. Some older panels and community panels that have not updated to the new panel and data model will be missing either all or some of these field options.

Most field options will not affect the visualization until you click outside of the field option box you are editing or press Enter.

For more information about applying these options, refer to:

Note: We are constantly working to add and expand options for all visualization, so all options might not be available for all visualizations.

Decimals

Number of decimals to render value with. Leave empty for Grafana to use the number of decimals provided by the data source.

To change this setting, type a number in the field and then click outside the field or press Enter.

Data links

Lets you control the URL to which a value or visualization link.

For more information and instructions, refer to Data links.

Display name

Lets you set the display title of all fields. You can use variables in the field title.

When multiple stats, fields, or series are shown, this field controls the title in each stat. You can use expressions like ${__field.name} to use only the series name or the field name in title.

Given a field with a name of Temp, and labels of {“Loc”=“PBI”, “Sensor”=“3”}

Expression syntax	Example	Renders to	Explanation
`${__field.displayName}`	Same as syntax	`Temp {Loc="PBI", Sensor="3"}`	Displays the field name, and labels in `{}` if they are present. If there is only one label key in the response, then for the label portion, Grafana displays the value of the label without the enclosing braces.
`${__field.name}`	Same as syntax	`Temp`	Displays the name of the field (without labels).
`${__field.labels}`	Same as syntax	`Loc="PBI", Sensor="3"`	Displays the labels without the name.
`${__field.labels.X}`	`${__field.labels.Loc}`	`PBI`	Displays the value of the specified label key.
`${__field.labels.__values}`	Same as Syntax	`PBI, 3`	Displays the values of the labels separated by a comma (without label keys).

If the value is an empty string after rendering the expression for a particular field, then the default display method is used.

Max

Lets you set the maximum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields

Min

Lets you set the minimum value used in percentage threshold calculations. Leave blank for auto calculation based on all series and fields

No value

Enter what Grafana should display if the field value is empty or null.

Unit

Lets you choose what unit a field should use. Click in the Unit field, then drill down until you find the unit you want. The unit you select is applied to all fields except time.

Custom units

You can use the unit dropdown to also specify custom units, custom prefix or suffix and date time formats.

To select a custom unit enter the unit and select the last Custom: xxx option in the dropdown.

If y u want a space -> If you want a space
suffix:<suffix> for custom unit that should go after value.
time:<format> For custom date time formats type for example time:YYYY-MM-DD. See formats for the format syntax and options.
si:<base scale><unit characters> for custom SI units. For example: si: mF. This one is a bit more advanced as you can specify both a unit and the source data scale. So if your source data is represented as milli (thousands of) something prefix the unit with that SI scale character.
count:<unit> for a custom count unit.
currency:<unit> for custom a currency unit.

You can also paste a native emoji in the unit picker and pick it as a custom unit:

String units

Grafana can sometime be too aggressive in parsing strings and displaying them as numbers. To make Grafana show the original string create a field override and add a unit property with the string unit.

Color scheme

Note: Only available in Grafana 7.3+.

The color scheme option defines how Grafana colors series or fields. There are multiple modes here that work very differently and their utility depends largely on what visualization you currently have selected.

Color by value In addition to deriving color from thresholds there are also continuous (gradient) color schemes. Useful for visualizations that color individual values. For example stat panels and the table panel. Continuous color modes use the percentage of a value relative to min and max to interpolate a color.

Color mode	Description
Single color	Specify a single color, useful in an override rule
From thresholds	Informs Grafana to take the color from the matching threshold
Classic palette	Grafana will assign color by looking up a color in a palette by series index. Useful for Graphs and pie charts and other categorical data visualizations
Green-Yellow-Red (by value)	Continuous color scheme
Blue-Yellow-Red (by value)	Continuous color scheme
Blues (by value)	Continuous color scheme (panel background to blue)
Reds (by value)	Continuous color scheme (panel background color to blue)
Greens (by value)	Continuous color scheme (panel background color to blue)
Purple (by value)	Continuous color scheme (panel background color to blue)

Thresholds

Thresholds allow you to change the color of a field based on the value.

For more information and instructions, refer to Thresholds.

Value mapping

Lets you set rules that translate a field value or range of values into explicit text. You can add more than one value mapping.

Mapping type - Click an option.
- Value - Enter a value. If the field value is greater than or equal to the value, then the Text is displayed.
- From and To - Enter a range. If the field value is between or equal to the values in the range, then the Text is displayed.
Text - Text that is displayed if the conditions are met in a field. This field accepts variables.