home User Guide Getting Started Help Center Documentation Community Training Certification
Looker keyboard_arrow_down
language keyboard_arrow_down
Looker documentation will be moving to cloud.google.com on August 22, 2022!
All the information you rely on will be migrated and all docs.looker.com URLs will be redirected to the appropriate page.
Single value chart options

This page describes the options for editing single value charts in the visualization menu. Click the gear in the upper right corner of the visualization tab.

A single value visualization always displays a value from the first row. You can use sorting and filtering so that the desired data is in the first row.

If your query has multiple fields, you can hide fields from the visualization that you don’t want displayed. If your query has multiple unhidden fields, the single value visualization will use the following priority order to choose which field to display:

Single value visualizations have automatic font sizing. Looker chooses the largest standard font size that fully displays the current value. When there are several single value visualizations on a dashboard, they all display using the same font size for a consistent appearance. Since data can change, Looker dynamically adjusts the font size to fit the current data. If the smallest standard size cannot show the entire value in the space available (such as the dashboard tile), then the value is truncated by an ellipsis (…).

Options listed in the menu may be grayed out or hidden when they conflict with other settings that you have chosen.

Style menu options


Choose a color collection from the Collection drop-down menu. A collection lets you create themed visualizations and dashboards that look good together. You can see all the palettes in each of Looker's built-in color collections on the Color collections documentation page. Your Looker admin may also create a custom color collection for your organization.

Value Color

You can set the color of the single value visualization. The default is dark gray.

When you click the color swatch under Value Color, Looker displays a color picker where you can select a color, input a hex string like #2ca6cd, or input a CSS named color string like mediumblue.

You can also pick one of the colors from the color collection that you selected in the Collection drop-down. To do so, click the Palettes tab on the color picker to scroll through the categorical palettes in that collection.

Looker will use the selected color for single value visualizations both with and without hyperlinks.

Depending on your needs, consider using the following alternate techniques:

Show Title

You can determine whether a title displays under the number. For a saved Look, the default title is the name of the Look. You also can specify a different title using the Title field.

Title Override

You can specify a title to display with the value. This field is available when Show Title is on. For a saved Look, if this field is left empty, the title defaults to the name of the saved Look.

Value Format

You can specify the format of the value, independent of the underlying dimension or measure. The field accepts Excel-style formatting. If no formatting is specified, the value displays in the format of the underlying dimension or measure.

MS Excel's complete guide details how to specify these formats in their documentation. However, color formatting is not currently supported in Looker.

For Looker developers: The formatting used in the Value Format field is the same as formatting that is used with the value_format LookML parameter, except that the value_format parameter requires the formatting string to be enclosed in double quotes. In the Value Format field, the formatting string is not enclosed in quotes.

The Adding custom formatting to numeric fields documentation page provides more information on how to use custom formatting.

Comparison menu options

Show Comparison

You can use a second field to add comparison information to your single value visualization. In general, the comparison value uses the next field that would be displayed as the single value visualization. If there is no other field in the first row to compare with, a field in the next row is used for comparison. You can affect which field displays by changing the order of fields or choosing Hide from Visualization for fields that you want to skip.

Value Labels

You can specify how the comparison field is used in the single value visualization:

Positive Values Are Bad

Positive Values Are Bad specifies the text and triangle colors that display for the comparison field. When Positive Values Are Bad is turned on, Looker displays the negative numbers as green text with a green triangle, while positive numbers appear as red text with a red triangle. This parameter is only available when the Style is set to Show as Change.

Show Label

You can determine whether a label is shown with the comparison field. By default, the label is the name of the comparison field.


You can provide a different label to the comparison field's name. This option is only available when Show Label is on.

Formatting menu options

Turn on Enable Conditional Formatting to define rules that color code your visualization by specifying values that are of interest.

Selecting a color collection

A collection lets you create themed visualizations and dashboards that look good together. All of Looker's built-in color collections appear on the Color collections documentation page. Your Looker admin may also create a custom color collection for your organization.

You can choose a color collection from the Collection drop-down menu. The palettes that appear for the color swatches in each rule come from that collection.

Defining formatting rules

You specify how to color code your visualization in the Rules section.

When you first enable conditional formatting, there will be one rule, set to the default of If value is equal to and the background color is set to the first color of the first categorical palette in the collection you selected.


Click the Format drop-down to begin customizing the rule.

Format value ranges such as between, not between, greater than, and less than are exclusive of the numbers listed at the boundaries of that range. For example, if you set a rule with a range If value is between 9 and 14 the rule applies to values 10 through 13.

When you enter values into the rule, do not use thousands separators.


Click the color swatches next to Background color or Font color to pull up the palette picker, which lets you pick or customize a color. If you select the Custom tab of the palette picker, you can use the color wheel and value slider to choose a custom color, or you can enter a RGB hex string, such as #2ca6cd, or CSS color names, such as mediumblue, into the input field.

Multiple rules

To add an additional rule, click Add Rule. If you have more than one rule, the rules higher on the list have precedence over rules lower on the list. To change the precedence of a rule, click on the three horizontal bars at the top left of that rule and drag the rule higher or lower in the list.

To delete a rule, click on the trash can icon in the top right corner of that rule section.