Table (legacy) charts provide direct views of your data. They can be formatted to illustrate elements of the data that you’d like to highlight. For example, the use of conditional formatting in the table (legacy) chart below colors the data cells along a scale to show lower order counts in the red range and higher order counts in the yellow and green ranges. Furthermore, orders over 1,000 are formatted in bold.
Building a table (legacy) chart
You can choose to use a table (legacy) chart by running a query, clicking the ellipsis (…) in the Visualization bar, and choosing Table (Legacy).
Table (legacy) charts accept dimensions, measures, pivots, table calculations, custom fields, and row or column totals. Table (legacy) charts support up to 5,000 rows, and 50 or fewer columns are recommended.
Once your chart is created, you can edit your table (legacy) visualization in the visualization menu. This menu can be accessed by clicking the gear in the upper right corner of the Visualization bar.
Some of the options listed below may be grayed out or hidden in situations where they would conflict with other settings you have chosen.
Data bar options
Several options on the Data bar can affect both your visualization and the data table.
If your chart contains pivots, you can add row totals to your chart by checking the Row Totals checkbox in the Data bar. See the Exploring data in Looker documentation page for more information.
The arrow to the right of the Row Totals checkbox allows you to toggle the placement of the totals column between the far right default placement and a placement further to the left, after dimensions and dimension table calculations.
You can add column totals for measures and table calculations by selecting Totals in the Data bar. See the Exploring data in Looker documentation page for more information.
If your data table contains pivots, you can add a column limit to your chart by entering any number between 1 and 200 in the Column Limit box. Dimensions, dimension table calculations, row total columns, and measure table calculations outside of pivots are not counted toward the column limit. Pivoted groups each count as one column toward the column limit. See the Filtering and limiting data documentation page for more information.
You can add a row limit to your chart by entering any number between 1 and 5,000 into the Row Limit box on the Data tab. If your query exceeds the row limit you have set, you cannot sort row total or table calculation columns.
You can add table calculations to your chart by clicking the Calculations button on the Data tab. See the Using table calculations documentation page for more information.
Plot menu options
Table Theme provides several table coloring options:
Classic: The table appears as it does in the Data section, with blue dimensions, orange measures, and green table calculations.
White: The table header is white, the data rows alternate between white and gray, and the text is black.
Gray: The table header is gray, the data rows alternate between white and light gray, and the text is dark gray.
Transparent: The table header is totally transparent, the data rows alternate between totally transparent and translucent gray, and the text adjusts itself in color. This can be useful when using a customized, embedded dashboard so that the tile background color shows through the visualization. On such a dashboard, the text color adapts to the background color, changing from black to white as needed. On the Explore page or in an embedded Look, the background is always white under the transparent visualization.
Unstyled: The entire table is white, the data rows are separated by gray lines, and the text is black.
Show Row Numbers
Show Row Numbers toggles whether to show a row number at the beginning of each table row.
If your Explore includes column totals, Hide Totals toggles whether to show the totals in the visualization.
Hide Row Totals
If your Explore includes row totals, Hide Row Totals toggles whether to show the row totals in the visualization.
Limit Displayed Rows
Limit Displayed Rows enables you to show or hide rows in a visualization, based on their position in the results. For example, if your visualization was displaying a 7-day rolling average, you may want to hide the first 6 rows.
Click Limit Displayed Rows to enable or disable this feature. Once enabled, you can specify the following options:
- Hide or Show: Choose Hide to exclude certain rows from the visualization. Choose Show to display only a limited number of rows in the visualization.
- First or Last: Choose if the rows to be hidden or shown will be the first or last rows in the result set.
- Number: Specify the number of rows to be hidden or shown.
In the Data section below your visualization, any excluded rows will be shown in a darker color and will be marked with a symbol to the left of the row number:
This option is dependent on the row order, so changing the query's sort order or adding a row limit can change the rows that are shown or hidden in the visualization.
Series menu options
The series menu controls how your chart shows each data series.In a table (legacy) chart, each column is listed in the series menu for customization.
Truncate Column Names
Truncate Column Names determines whether column headers should be shortened with an ellipsis (
...). If you need to shorten column names, you can also turn off the Show Full Field Name option.
Show Full Field Name
Show Full Field Name toggles whether to show the view name along with the field name for each column header. When Show Full Field Name is off, generally only the field name shows; however, measures of type
count display only the view name instead.
The Customizations section lists each column in the visualization and lets you create a custom label for that column in the Label box.
Tooltips for Table Columns
If the underlying data model defines a description for a field or measure, that description is displayed when you hover over the column name in a table (legacy) chart visualization:
Formatting menu options
Enable Conditional Formatting
Turn on Enable Conditional Formatting to define rules that color code your visualization, either on a scale or by specifying values that are of interest.
The image below shows a sample visualization where all values are colored on a scale, changing from red to yellow to green as the values scale from low to medium to high:
This second example shows a visualization where all values over 5,000 are highlighted and made bold:
Selecting a color collection
To set up your color coding, first choose a color collection from the Collection drop-down menu. A collection allows you to 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.
Once you select the color collection, the Palette section for each rule will update with a palette 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 color coding on a scale.
- To add an additional rule, click Add Rule.
- To delete a rule, click on the trash can icon in the top right corner of that rule section.
You can choose whether to apply a rule to all numeric fields in the visualization, or to apply the rule just to one or more fields using the Apply to box:
If you choose All numeric fields, the conditional formatting rule will be applied to every value in all the numeric fields in the visualization. If you are color coding values on a scale, the scale will include all numeric values, even if the values in different columns are unrelated.
If you create multiple rules using All numeric fields, 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.
If you choose Select fields, Looker displays a box that lets you select the fields where you want to apply the rule. If you enter text in the box, Looker lists only the fields that include that text.
Select the field or fields where you want to apply the rule, and the conditional formatting will be applied only to the values in those fields.
If you create multiple rules on the same field, only the rule highest on the list applies to the visualization and the other rules are inactive. To move a rule higher or lower on the list, click on the three horizontal bars at the top left of that rule and drag the rule higher or lower in the list.
The example below shows two numerical fields. The first rule, which applies a red background color to any value below 46, applies only to the Average Sale Price field. The second rule, which color codes on a scale from red to green, applies only to the Order Count field:
In the Format box, choose whether to color code values along a scale or based on a logical condition:
If you choose to format based on a logical condition, when you enter a value in the Format box, do not use thousands separators.
Color coding on a scale
If you are color coding values on a scale, click the color palette to choose your colors:
You can choose one of several existing palettes, or you can create a custom palette. To create a custom palette, click on the Custom tab of the palette picker. There you have several options:
- Add or remove colors from the scale by clicking the + or - buttons. You can have a maximum of 5 and a minimum of 2 colors on your scale.
- Edit all the colors of the scale by clicking Edit All and entering RGB hex strings, such as
#2ca6cd, or CSS color names, such as
- Use the color wheel to choose a custom color for the highlighted part of your color scale.
In addition, if you are color coding values on a scale, you can use the following options to modify the color coding:
- Select Reverse colors to apply the colors at the left end of the palette to values in the higher end of the data range and colors at the right end of the palette to values in the lower end of the data range.
- Select Use X color steps to limit the number of colors used to the specified step value. When this option is not enabled, the data is colored on a gradient covering the entire palette spectrum. When this option is enabled, the data is then grouped and colored according to the number of color steps. For example, if you specify 5 color steps, the data is grouped into 5 equal buckets and the 5 colors applied, one color to each bucket of data. Valid color step numbers are from 2 to 100, inclusive.
- Select Mirror range around center value to make equal color shifts on either side of the color palette. For example, on a scale from -100 to 0 to 100, values of -20 and 20 will be the same color distance (10%) from the center color definition — 40% and 60% of the palette gradient respectively.
- Use the Range fields to specify the values that determine the palette gradient start (0%), center (50%), and end (100%) colors. For the start and end colors, you can specify the minimum and maximum values in your data, specific numeric values, or percentile values. For the center value, you can specify the midpoint of the minimum and maximum data values, the data average, the data median, a specific numeric value, or a percentile value. For example, specifying start and end percentile values of 1% and 99% respectively, with a center value of 75%, causes the bottom half of the color gradient to apply to the lower 75% of your data values, and the upper half of the color gradient to apply to the top 25% of your data values.
Color coding based on a logical condition
If you are color coding values based on a logical condition (in other words, using one of the Format options beginning with If value is), choose the Background Color, Font Color, and Font Style for values that meet the condition. By default, the background color is set to the first color of the categorical palette you have chosen for your conditional formatting rule.
If conditional formatting is enabled, Include Totals toggles whether totals are included in the color coding scheme.
Include Null Values as Zero
If conditional formatting is enabled, Include Null Values as Zero toggles whether null values should be represented as a zero.