---
title: "Treemap in Vista | Oplema"
description: "Make a treemap in Vista: show the shares of a total as nested tiles, which stay readable with many parts or two levels of category."
url: "https://oplema.com/docs/vista/part-to-whole/treemap"
updated: "2026-11-04"
---

# Treemap

Treemap divides a rectangle into tiles sized by their share of the total. It stays readable with many parts, and a Breakdown adds a second level inside each tile.

## Split units by department and item

Four items are sized by units sold inside their department. Drinks and Food each total 50 units, split into Tea and Coffee, and Bread and Cake.

Result
| Department | Item | Units |
| --- | --- | --- |
| Drinks | Tea | 20 |
| Drinks | Coffee | 30 |
| Food | Bread | 30 |
| Food | Cake | 20 |

1. In the Data tab, use Remove next to Breakdown to show departments only.
2. Change Operation from `Sum` to `Count rows`. The tiles resize to the number of rows.
3. Open the Design tab and expand Labels to change what the tiles show.

## When to use

Use Treemap for a total with too many parts for a pie, or for parts that belong to groups, because a tile needs less room than a slice. When following the levels from the center out is the point, use Sunburst.

## Inputs

1 port

**Table**

Accepts: Tables.

Accepts one connection on this port.

## Settings

**Group by**

Column for the parts. Auto picks a readable one.

**Group dates by**

How dates in this field are grouped, such as by day, month or year.

Default: `Day`

Options: Exact, Second, Minute, Hour, Day, Week, Month, Quarter, Year, Month of year, Day of week, Hour of day.

**Grouping**

Groups each number on its own, or into equal-width ranges.

Default: `Individual values`

Options: Individual values, Fixed-width ranges.

**Part value**

Column calculated into the size of each part. Auto picks one with varied values.

**Operation**

How the value column is calculated for each category. Columns that aren't numeric are counted.

Default: `Sum`

Options: Sum, Average, Median, Minimum, Maximum, 25th percentile, 75th percentile, 90th percentile, 95th percentile, Percentile, First by time, Last by time, Count values, Count distinct, Count rows, Count true, Percentage true.

**Breakdown**

Second split level inside each part.

**Sort by**

Sorts parts by their value.

Default: `Default`

Options: Default, Ascending, Descending, Group ascending, Group descending.

28 more settings

**Period size**

Number of units in each period. Hours, minutes and seconds count fixed intervals from 1970-01-01 in the chart's time zone. Calendar periods follow local boundaries.

Default: `1`

**Source timezone**

IANA time zone for timestamps without an offset, such as Europe/Copenhagen. Ambiguous local times need an explicit offset.

Default: `UTC`

**Chart timezone**

IANA time zone used for grouping and display. Vista filters keep their own time zone.

Default: `UTC`

**Week starts**

Day the week starts on.

Default: `Monday`

Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.

**Fiscal year starts**

Month the fiscal year starts in. Sets quarter and year boundaries.

Default: `January`

Options: January, February, March, April, May, June, July, August, September, October, November, December.

**showTooltip**

Shows or hides values when you hover over a mark.

Default: `true`

**Tooltip**

Use the automatic summary, or write your own text with values.

Default: `Automatic`

Options: Automatic, Custom.

**Values**

Values you can insert into the text. Each row calculates a value from a source field or, in charts, shows a chart value, and can have its own number or date format.

**Date labels**

How dates are written in the chart labels.

Default: `Auto`

Options: Auto, Iso, Date, Datetime, Custom.

**Tooltip dates**

How dates are written in tooltips.

Default: `Iso`

Options: Auto, Iso, Date, Datetime, Custom.

**Tooltip decimal places**

\-1 uses the measure's format.

Default: `-1`

**Thousands separators**

Groups digits with thousands separators in tooltip numbers.

Default: `true`

**Title**

Title shown inside the chart. Leave empty to hide it.

**Title color**

Color of the title.

**Title size**

Size of the title, in pixels.

Default: `24`

**Title alignment (plot)**

Alignment of the title.

Default: `Left`

Options: Left, Center, Right.

**Layout**

How the breakdown is arranged: nested inside each split, one flat level colored by breakdown or one band per split.

Default: `Nested`

Options: Nested, Flat, Bands.

**Tile gap**

Space between tiles, in pixels.

Default: `0`

**Tile labels**

What each tile label shows.

Default: `Split`

Options: None, Split, Measure, Split + measure.

**Label size**

Size of the tile labels, in pixels.

Default: `11`

**Label color**

Color of the tile labels.

**Label align**

Horizontal position of the label in the tile.

Default: `Center`

Options: Left, Center, Right.

**Label vertical align**

Vertical position of the label in the tile.

Default: `Middle`

Options: Top, Middle, Bottom.

**Split headers**

Shows or hides a header strip on each split.

Default: `false`

**Background**

Card background color. Auto follows the theme.

**Plot padding**

Space between the card edge and the chart, in pixels.

Default: `0`

**Corner radius (px)**

Corner radius in whole logical pixels.

Default: `0`

**Border width (px)**

Border width in whole logical pixels.

Default: `0`

## Treemap FAQs

**How do parent tiles get their size in a treemap?**

Parents sum the areas of their children, and a parent's tooltip uses all rows in its path.

### Chart your data. Build it in Vista.

Vista opens in your browser, with no account.

[Open Vista](https://oplema.com/editor?path=%2F%3Fopen%3Dvista) [About Vista](https://oplema.com/vista)
