This article is about Looker Studio. For Looker documentation, visit

Table reference

How to use and configure tables.

Tables display your data in a grid of rows and columns. Each column represents a dimension or metric, while each row is one record of your data.

Learn how to add charts to your reports.

In this article:

Tables in Looker Studio

Tables in Looker Studio automatically group your data. Each row in the table displays the unique combination of all the dimensions included in the table definition. Each metric in the table is aggregated according to the aggregation type for that metric (sum, average, count, etc.). 

Table examples

Here is some sales data for a fictional pet store. The store sells items for dogs, cats, and birds, with several products in each category.

Date Item Category Qty Sold


Happy Cat Catnip Cat 1


Healthy Dog Dog Food Dog 3


Pretty Bird Bird Seed Bird 5


Pretty Bird Bird Seed Bird 3


Happy Cat Catnip Cat 2


Playful Puppy Toy Dog 6


Pretty Bird Bird Seed Bird 7

Data continues...

... ... ...


A simple Looker Studio table showing just the category dimension and quantity metric looks like this:

Category Qty Sold
Bird 28
Dog 27
Cat 12

Example table 1

In example 1, Looker Studio has aggregated the quantities sold per category. Since there are only 3 categories in the data set, the table shows just 3 rows.

Now let's add the Item dimension to the table:

Category Item Qty Sold
Bird Pretty Bird Bird Seed 20
Dog Healthy Dog Dog Food 17
Dog Playful Puppy Toy 10
Bird Parrot Perch 8
Cat Happy Cat Catnip


Cat Hungry Kitty Cat Food 3

Example table 2

In example 2, the table contains 6 rows, 1 for each item. The quantity sold metric is now aggregated per item.

The metric's aggregation type depends on how the data source is configured. Learn how to change a metric's aggregation type.

Add a table to your report

To add a table to a report:

  1. Edit your report.
  2. At the top, click Add a chart.
  3. Select a default table style.
    1. For example, you can add a standard table, a table where the metrics are displayed as bars, or a table with a heatmap applied.
  4. Drag the chart to the desired location on the page and resize it to the desired dimensions.
  5. Use the properties panel on the right to add metrics and dimensions and to style the table.

Adjust column size

To manually change the size of individual columns in the table, click a column divider and drag it. To resize multiple columns at once, hold the Shift key while dragging a column divider.

To apply automated column resizing, right-click the table, then select one of the Resize columns option:

  • Fit to data sizes each column in the table to the optimum width according to the data.
  • Distribute evenly makes all the columns equal width.
You can also simply double-click on a column divider to apply the Fit to data option.

Watch a demonstration of resizing table columns

A user selects and drags table columns horizontally to resize them.

Configure the chart

Add a new chart or select an existing chart. Then, on the right, use the Properties panel to configure the chart's Setup and Style tab properties.

Set up the chart data


The options in the SETUP tab determine how the chart's data is organized and displayed.

Data source

A data source provides the connection between the component and the underlying dataset. 

  • To change the chart's data source, click the current data source name.
  • To view or edit the data source, click Edit. (You must have at least view permission to see this icon.)
  • Click +BLEND DATA to see data from multiple data sources in the same chart. Learn more about data blending.


Dimensions are data categories. Dimension values (the data contained by the dimension) are names, descriptions, or other characteristics of a category.

Drill down

This option appears on charts that support it.

Drilling down gives viewers a way to reveal additional levels of detail within a chart. When you turn on the Drill down  optioneach dimension you add becomes another level of detail you can drill into. Learn more about chart drill down.


Metrics measure the things that are contained in dimensions and provide the numeric scale and data series for the chart.

Metrics are aggregations that come from the underlying data set, or that are the result of implicitly or explicitly applying an aggregation function, such as COUNT(), SUM(), or AVG(). The metric itself has no defined set of values, so you can’t group by it as you can with a dimension.

Learn more about aggregation.

Optional metrics

Define a list of additional metrics that can be displayed by the chart or table. Learn more about optional metrics.

Metric sliders

Let report users filter the chart or table by metric values. Learn more about metric sliders.

Sort your data

Viewers of your reports can sort the data by clicking on a column header. Each click reverses the sort order: e.g., click once to sort in ascending (lowest to highest) order, click again to sort in descending (highest to lowest) order. In the example above, the table is sorted by Qty Sold in descending order. Viewers can still sort the chart even if the editor has defined a default sort.

If a viewer changes the sort order of a chart, and that chart was sorted by a metric not displayed in the chart, refreshing the page restores the default sorting.

When a secondary sort field is selected, the primary and secondary sort fields are numbered in the table 1 and 2, respectively. Sorting by any other field (by clicking the field name in the table header) removes the primary and secondary sorts.

Set the default sort

The Sort and Secondary sort options in the chart's setup panel control the default sorting behavior. You can select any metric in the chart's data source, or any dimension that is currently displayed in the chart, to use as the primary or secondary sorting field.

The Secondary sort option only appears when there is an appropriate combination of dimensions and metrics in the chart.
When you specify a metric as a sort field, you can edit the field's aggregation. For example, you could include a numeric field in the chart as a SUM, but sort on that same field's AVERAGE value.

Rows per page

Use the Rows per page option to control how many table rows to display per table page. Show pagination must be enabled for this to take effect.

Show summary row

The Show summary row option toggles display of a row at the bottom of a table summarizing each metric column.

Default date range

The Default date range property lets you set a timeframe for an individual chart.

Default date range options

Auto Uses the default date range, which is determined by the chart's data source.
Custom Lets you use the calendar widget to select a custom date range for the chart.
Date compare type Displays comparison data for the selected time period.

Learn more about working with dates and time. 


Filters restrict the data that is displayed in the component by including or excluding the values that you specify. Learn more about the filter property.

Filter options

Filter name Click an existing filter to edit it. Mouse over the filter name and click X to delete it.
+Add a filter Click this option to create a new filter for the chart.

Chart interactions

When the Cross-filtering option is enabled on a chart, that chart acts like a filter control. You can filter the report by clicking or brushing your mouse across the chart. Learn more about cross-filtering.

Stylize the chart

The options in the Style tab control the overall presentation and appearance of the chart.


By default, the table position is set to Vertical. To transpose the table, click the Horizontal button.

Table Header

These options control the appearance of the table header and column labels.

Show header Shows or hides the table header. Note that viewers can't sort tables with hidden headers.
Wrap text Wraps header text.
Header font color Sets the font color of the table header.
Header font size Sets the font size of the table header.
Header font family Sets the font family of the table header.

Table Colors

These options control the colors of the table borders and cells.

Header background color Sets the color of the table header background.
Cell border color Sets the color of the border between rows.
Odd/Even row color Sets the color of odd or even rows in the table.

Table Labels

These options control the appearance of the table data.

Font color Sets the font color of the data.
Font size Sets the font size of the data.
Font family Sets the font family of the data.
Heatmap text contrast Sets the font color automatically when displaying a heatmap. Choose from 3 levels of contrast, low, medium, or high.

Table Body

These options control the appearance of the table body.

Row numbers Adds row numbering as the leftmost column of the table.
Auto-height Resizes row height to fit the content.
Wrap text Wraps long text in the table body.
Horizontal scrolling

Adds a horizontal scrollbar to the bottom of the table.

When Horizontal scrolling is enabled, users can freeze columns while viewing the report.
Freeze column number

Freeze all columns up to the selected column number.

Freezing columns is unavailable when the table is transposed.

These options control the appearance of the table footer.

Show pagination Pagination lets the viewer navigate through long tables. Show or hide the page controls with this option.
Compact pagination Reduces the vertical spacing of the pagination controls.
Footer border color Sets the footer border color.
Footer border weight Sets the thickness of the footer border.
Footer border style Sets the line style of the footer border.

Missing data

This option controls how to display missing values. For example, when data is missing from the table, you can choose to show blanks, hyphens, or the words "no data."

Dimension and metric appearance

These options control the display of your dimension and metric columns. Each column in your table has a corresponding numbered section in the properties panel: from left to right, the first metric in the table is Column #1, the second metric is Column #2, and so on. You can set the following options for each column:

Number display

  • Number - displays the metric value "as is."
  • Heatmap - displays the metric value with a colored background, the intensity of which shows how that value compares to the other values in that column.
    Use the Heatmap text contrast option (in the Table Labels section above) to set the font color automatically to provide better readability of your data labels. Choose from 3 levels of contrast: Low, Medium, or High.
  • Bar - displays the metric value as a horizontal bar. You can change the bar color and include the numeric value, as well, if desired.
Alignment Aligns the data in the column left, right, or center.
Compact Numbers

Rounds numbers and displays the unit indicator. For example, 553,939 becomes 553.9K.

Decimal Precision Sets the number of decimal places in metric values.
Show target Appears when the column type is set to Bar. Shows a target line for the value set in the target value field, similar to a bullet chart.
Show axis Displays an X-axis for the bar chart.

Chart header

The chart header lets viewers perform various actions on the chart, such as exporting the data, drilling up or down, or sorting the chart. Chart header options are as follows:

Show on hover (default) Three vertical dots appear when you mouse over the chart header. Click these to access the header options.
Always show The header options always appear.
Do not show The header options never appear. Note that report viewers can always access the options by right-clicking the chart.
Color Sets the color of the chart header options.

Limits of tables

The number of dimensions and metrics you can add depends on the data source used by that table:

  • Tables based on "fixed schema" data sources, such as Google Analytics, Google Ads, Display & Video 360, and other Google marketing products data sources can have up to 10 dimensions and 20 metrics.
  • Tables based on "flexible schema" data sources, such as Google Sheets, BigQuery, and SQL databases can have up to 100 dimensions and 100 metrics.

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center