Treemap reference

How to use and configure treemap charts.

A treemap shows your data organized into dimension hierarchies. For example, you can use a treemap to show the average annual sales of each item in a product category > subcategory > product hierarchy.

Learn how to add charts to your reports.

In this article:

Blocks of varying shapes and colors are arranged to show an abstract representation of a Looker Studio treemap visualization.

Treemaps in Looker Studio

Data in a treemap is displayed in "branches" (also called "nodes"). Each branch can have zero or more sub-branches, and one parent branch (except for the root, which has no parents). Each branch is displayed as a rectangle, sized and colored according to the values in your data. Sizes and colors are valued relative to all other branches in the graph.

Treemaps are a good hypothesis-generation tool because they can help expose the relative importance of, and the relationship between, different entities.

Treemap examples

The treemap below displays the number of items sold by an online pet store. The branch labels come from the Department ("Department") and Item ("Item") dimensions.

A treemap displays Avian, Canine, and Feline Department dimension categories and related Item dimension values.

Here's how the underlying data for this chart is organized:

A Google Sheet with data organized in columns labeled Date, Department, Item, Qty sold, and Price.

Configure the chart

Select the chart. Then, on the right, use the property panel to configure the chart options.

Setup properties

The options in a chart's setup panel determine how the data is organized and displayed.

Data source

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

  • 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.

Levels to show

The Levels to show option determines the granularity of the chart. For example, the sample chart above has Levels to show set to 2, causing it to show two levels of detail (Department and Item).

Setting Levels to show to 1 causes the chart to display only one level of detail (Department):

A treemap with the Levels to show option set to 1 displays only Department-level details.

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.

What's the difference between drill down and levels to show?

Drill down lets you focus on a specific level of detail, while Levels to show controls how many levels of detail appear in the treemap. For example, here's the result of drilling down into the chart above. Note that it now displays only one level of detail, but that level is now the Item level.

A treemap displays item details when a user drills into the Item dimension.

See an example of a treemap with drill down turned on (Note: the report is in English only).

Total rows

Treemaps can display from 5 to 5000 rows of data.

Default date range

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

Default date range options

Auto Use 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 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.

Style properties

A chart's style properties control the overall presentation and appearance of the chart.


Max color value Set the color for the highest metric value.
Mid color value Set the color for the median metric value.
Min color value Set the color for the minimum metric value.
Show branch header Show or hide the parent branches.
Show scale Show or hide the chart scale, which appears above the treemap. To see the scale in action, hover over different branches in the chart.


Set the font color, font size, and font family for text in the chart.

Background and border

These options control the appearance of the chart background container.

Background Sets the chart background color.
Border Radius Adds rounded borders to the chart background. When the radius is 0, the background shape has 90° corners. Border radius of 100° produces a circular shape.
Opacity Sets the chart's opacity. 100% opacity completely hides objects behind the chart. 0% opacity makes the chart invisible.
Border Color Sets the chart border color.
Border Weight Sets the chart border line thickness.
Border Style Sets the chart border line style.
Add border shadow Adds a shadow to the chart lower and right borders.

Chart Header

The chart header lets viewers perform various actions on the chart, such as exporting the data, drilling up or down, and viewing the chart in the Explorer tool. Chart header options are:

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 Set the color of the chart header options.
Was this helpful?
How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center