Treemap Plume: every field and every setting explained

This page describes everything Treemap Plume offers: the field wells, then each card of the Format pane, in the order they appear. Each setting's default value is in bold, premium features carry a ★. For a guided first visual, see the getting started guide.

The visual's fields

Field	Required?	How many	What goes in	What it does	Example
Category (groups)	Yes (or Details)	1 to 6	Columns	The levels, from the largest group to the smallest	Region, City
Details	No	1	A column	One last level of sub-tiles, like the Power BI treemap	Product
Values	No	1	A measure	The area of the tiles (no measure: row count)	Revenue
Color (measure)	No	1	A measure	Gradient colors (automatic as soon as the field is filled), diverging ★, thresholds ★, or the change of a stock map ★	Margin rate
Comparison ★	No	1	A measure	The previous value: change ▲▼, stock map	Revenue 2024
Image ★	No	1	A text column or measure	A base64 image in each tile	Logo
Small multiples ★	No	1	A column	One treemap per value, side by side	Channel
Play axis ★	No	1	A column (year, date, ordered category)	Animates the treemap from one value to the next	Year
Tooltips	No	Several	Measures	Added to each tile's tooltip	Orders
Dynamic format	No	Several	Measures named card.setting	Drive a setting with DAX (see Dynamic formats)	title.text

Category (groups). The order of the fields in the well is the order of the levels. All levels are nested: each group has its header and its total (Levels shown at once setting to show only part of them). Blank values form a "(Blank)" tile.

Details. Adds a level below the last category. It mostly matches the logic of the Power BI treemap (Category + Details); with Treemap Plume, you can also put this field last in Category (groups).

Values. Negative or blank values have no area: they count as 0 and a message says so in edit mode. A group's area is the sum of its tiles.

Color (measure). Read by the Gradient, Diverging ★, Thresholds ★ and Stock map ★ colorings (a change already computed, see Change read from). As long as you have not changed the Coloring, filling this field switches the treemap to a gradient; if you chose a coloring that does not use this field, a message says so in edit mode. For a group shown as a single tile (limited levels), the color is the size-weighted average of its tiles.

Comparison ★. The change is (value − comparison) / comparison. It appears in the labels ("▲ +12%") and the tooltip, and colors the tiles with the Stock map coloring.

Image ★. Only embedded images are read: data:image/png;base64,…, raw base64, or SVG. Web addresses are never loaded.

Play axis ★. Premium feature: a "Premium preview" watermark without a key as soon as the field holds data. Numbers and dates are read in ascending order, texts in data order. Selecting a tile does not filter the year: it filters the category.

Format pane settings

The cards shared by every Plume visual (Plume Studio License, Style, Tooltips, Title, Source note, Frame, Language and numbers) and the two basic settings of the Interactions card are described in the common basics. Here are the cards specific to Treemap Plume, in the order of the pane. Color and text settings have the fx button: a measure or a rule can drive them.

Layout

How the tiles share the space.

Setting	What it does	Options (default in bold)
Tiling method	Squarified: near-square tiles, the most readable; Binary: cuts into two halves of equal weight; Alternating: columns at the first level, rows at the next; Voronoi: polygonal cells inside a shape	Squarified · Binary · Alternating (columns, rows) · Rows · Columns · Voronoi (cells) ★
Voronoi shape	Outline of the Voronoi; shapes without ★: circle, square, rounded square, rectangle, triangle, diamond, hexagon, star, heart, cloud, drop, bubble, arrow, person, house (shown when Tiling method = Voronoi (cells))	Circle · Square · Rounded square · Rectangle · Triangle · Diamond · Hexagon · Star · Heart · Ellipse ★ · … (153 options, 22 of them free)
Tile order	The first tile is at the top left; Data order follows the model's sort-by-column	Value, descending · Value, ascending · Name (A → Z) · Name (Z → A) · Data order (Power BI sort)
Stable layout while playing	With a play axis: tiles keep their place from one frame to the next	on
Levels shown at once (0 = all)	1: one level, double-click to drill down, like the Power BI treemap	0 (0 to 7)
Space between tiles (px)	Gap between two neighboring tiles	1 (0 to 12)
Space between groups (px)	Gap between two groups	3 (0 to 24)
Tile corner radius	Rounded corners	0 (0 to 16)
Top N + "Others" ★	In each group, the N largest tiles; the rest in a hatched "Others" tile	off
Tiles kept per group	N (shown when Top N + "Others" = on)	10 (1 to 500)
"Others" label	Text of the tile (shown when Top N + "Others" = on)	text; empty

Data colors

Chooses how the tiles are colored. The settings shown depend on the chosen coloring; with One color per category or One color per tile, one color per value is offered at the bottom of the card (fx button available for categories).

Setting	What it does	Options (default in bold)
Coloring	Coloring mode	One color per category (top level) · One color per tile (last level) ★ · Single color · Gradient by a measure · Diverging around a midpoint ★ · Thresholds (3 colors) ★ · Stock map: change (Comparison field) ★ · Highlight ★
Color	Color of every tile (appears with Single color)	color; empty
One line per value	Color of each category (or each tile); fx button available for categories	color; the palette one
Shade tiles within a group	Smaller tiles of a group are slightly lighter, so neighboring tiles of the same color stand apart (appears with One color per category)	on
Start value (empty = minimum)	Value that takes the first gradient color (appears with Gradient)	text; empty
End value (empty = maximum)	Value that takes the last color (appears with Gradient)	text; empty
Midpoint value	Value that takes the middle color (appears with Diverging)	text; 0
Low threshold	Below: first color (appears with Thresholds)	text; empty
High threshold	Above: third color (appears with Thresholds)	text; empty
Below the low threshold	Color	color; #C0392B
Between thresholds	Color	color; #B8BCC6
Above the high threshold	Color	color; #2E7D4F
Change read from	Color field: a change measure (e.g. Change % = 0.034 or 3.4%) colors the tiles, whatever measure sizes them (market cap, sales…). Automatic: the Comparison field when it is filled, else the Color field; a measure with a percentage format, or whose values stay between -1.5 and 1.5, is read as a fraction (0.034 = 3.4%), otherwise as points (3.4 = 3.4%). (appears with Stock map)	Automatic (Comparison field, else Color field) · Values compared with the Comparison field · Color field (change already computed)
Automatic change range	The strongest color matches a round change (±1, 2, 3, 5, 10%…) reached by 90% of the tiles shown. Off: the value below. (appears with Stock map)	on
Change for the strongest color (%)	At this change, the tile takes the strongest favorable or unfavorable color; at 0%, gray (appears with Stock map, automatic range off)	3 (0.1 to 1000)
A decrease is favorable	Swaps the colors: a decrease in green (costs, delays) (appears with Stock map)	off
Highlighted categories	Comma-separated names, at any level (appears with Highlight)	text; empty
Highlight color (empty = accent)	Color of the named tiles	color; empty
Other tiles color (empty = gray)	Color of the other tiles	color; empty

Groups (headers and borders)

The header names each group and gives its total; clicking it zooms into the group.

Setting	What it does	Options (default in bold)
Group headers	Band at the top of each group large enough	on
Text size	Header text size	10 (7 to 24)
Bold	Bold text	on
Group total	Adds the total after the name	on
Header background	Band color	Group color · Neutral · None
Text color (empty = automatic)	White or dark depending on the background when empty	color; empty
Border around groups	Draws an outline around each group	off
Width	Outline width (shown when Border around groups = on)	1 (0.5 to 6)
Color (empty = secondary text)	Outline color (shown when Border around groups = on)	color; empty
Gap color between tiles (empty = background)	Color of the gaps and of the Voronoi outlines	color; empty

Data labels

The text written in the tiles.

Setting	What it does	Options (default in bold)
Show	Labels in the tiles	on
Value	—	on
Percentage	Share of the tile (shares stay free in the tooltip)	None · Share of the group ★ · Share of the total ★
Change ▲▼ (Comparison field)	Change versus the Comparison field	on
Position	Where the text goes	Top left · Center
Auto size	Text grows with the tile, from the minimum to the maximum size, and never overflows	on
Size (minimum)	Smallest size used	10 (6 to 40)
Maximum size	Largest size (shown when Auto size = on)	26 (8 to 80)
Hide in tiles narrower than (px)	No text in narrower tiles	24 (0 to 200)
Color (empty = automatic)	Automatic: white or dark depending on the tile color	color; empty
Display units	Thousands, millions…	Auto · None · Thousands · Millions · Billions
Decimals (-1 = auto)	Number of decimals	-1 (-1 to 6)
Prefix	Text before the value	text; empty
Suffix (e.g. €)	Text after the value	text; empty

A label that does not fit in its tile, even at the minimum size, is hidden rather than cut to "C…".

Category labels

The name written in each tile, set apart from the values (like the category labels of the native treemap). Before version 1.1, these settings were in the "Labels" card; existing reports keep them.

Setting	What it does	Options (default in bold)
Show	—	on
Bold	—	on
Lines for long names	The name wraps at spaces and after hyphens	2 (1 to 6)
Color (empty = same as data labels)	—	color; empty

Legend

Shown for colorings by a measure (color scale, thresholds, change) and, for One color per category, when the groups are not named on the treemap (headers hidden, Voronoi). Clicking a category selects its tiles; hovering a category dims the other groups.

Setting	What it does	Options (default in bold)
Show	Shown when the chart has several series.	on
Position	—	Top · Bottom · Right · Left
Alignment	(shown when Position = Top or Bottom)	Start · Center · End
Legend title	—	off
Title text	(shown when Legend title = on)	text; empty
Size	—	9 (6 to 24)
Color (empty = secondary text)	—	color; empty
Click = select the series	—	on

Zoom

The visual's own zoom (formerly the "Exploration (zoom)" card): it draws the whole hierarchy and drills into a group by itself, without the Power BI drill buttons.

Setting	What it does	Options (default in bold)
Click a header: zoom into the group	Ctrl + click on the header: select the whole group (cross-filter)	on
Double-click a tile: drill down one level	Zooms into the tile's group	on
Breadcrumb	Clickable path at the top of the visual after a zoom	on
Top level label	First item of the breadcrumb	text; empty

Keyboard: Alt + Down arrow zooms into the group of the focused tile, Backspace (or Alt + Up arrow) goes back up.

Images ★

Appears with an Image ★ field.

Setting	What it does	Options (default in bold)
Fit	Whole image below the label, or filling the tile	Whole (logo) · Fill the tile (photo)
Size (% of the tile)	Size of the whole image (shown when Fit = Whole (logo))	55 (10 to 100)
Opacity (%)	Image transparency	100 (5 to 100)
Round image	Clips the image as a circle (shown when Fit = Whole (logo))	off

Small multiples ★

Appears with a Small multiples ★ field.

Setting	What it does	Options (default in bold)
Columns (0 = automatic)	Number of panels per row	0 (0 to 12)
Comparable areas across panels	Each panel's area is proportional to its total	on
Title size	Size of each panel's name	11 (7 to 24)
Space between panels (px)	Gap between two panels	12 (0 to 40)

Playback ★

Appears with a Play axis ★ field. Card shared by the animated Plume visuals.

Setting	What it does	Options (default in bold)
Frame shown on opening	Year shown when the report opens	The last one (most recent) · The first one
Duration of a frame (ms)	At speed ×1; the speed button multiplies it (×0.5 to ×4) for the session	1000 (100 to 10000)
Loop	Starts over at the end	off
Play automatically on opening	Once, from the first frame; never when animations are reduced nor on a dashboard tile	off
Animated transitions	Tiles slide from one frame to the next	on
Play bar	Buttons, slider, speed	on
Bar position	(shown when Play bar = on)	Bottom · Top
Tick marks	Marks on the slider (shown when Play bar = on)	Automatic · Every frame · None
Tick labels	Years below the slider (shown when Play bar = on)	on
Start and end buttons	Go to the first or last frame (shown when Play bar = on)	on
Speed button	×0.5, ×1, ×2, ×4 (shown when Play bar = on)	on
Current value in large type	The year in large type on the treemap	on
Large value size	(shown when Current value in large type = on)	44 (12 to 160)
Large value position	(shown when Current value in large type = on)	Bottom right · Top right · Top left · Bottom left · Center

Tooltips

The common Tooltips card, with three settings specific to Treemap Plume (they were in the former "Tooltip" card).

Setting	What it does	Options (default in bold)
Show	Tooltip on hover (with the fields of the "Tooltips" well and report page tooltips).	on
Full path (every level)	Every category of the tile, otherwise only its own	on
Share of the group	Share of the tile in its group	on
Share of the total	Share of the tile in the total shown	on

Power BI report page tooltips are supported (Format › General › Tooltips of the container).

Premium features ★

Feature	Where to set it
Play axis (animation, stable layout)	Play axis ★ field, Format › Playback ★
One color per tile, diverging, thresholds	Format › Data colors › Coloring
Share of the group or of the total in labels	Format › Data labels › Percentage
Voronoi (cells) inside a shape	Format › Layout › Tiling method, Voronoi shape
Stock map (change)	Comparison ★ field and Format › Data colors › Coloring
Highlight	Format › Data colors › Coloring
Top N + "Others"	Format › Layout › Top N + "Others" ★
Images in tiles	Image ★ field, Format › Images ★
Small multiples	Small multiples ★ field, Format › Small multiples ★
17 styles, advanced palettes, JSON theme	Format › Style

Without a key, each one works with a "Premium preview" watermark (a badge in the footer in edit mode, a light pattern across the visual in the published report). The key is pasted in Format › Plume Studio License.