Settings

All options live in the property panel. Functional options are under Settings; look & feel is under Appearance › Style.

Period

Year — the year to display (e.g. 2024). Accepts a fixed value or an expression.

Layout

Months per row — how many months to place side by side (1–12, default 6). With 6, the twelve months form two rows.

Unit

Unit — a suffix/prefix shown next to values in tooltips and the legend (e.g. €, kg, pcs, %). Leave empty for none.
Position — whether the unit appears after (1.234 €) or before (€ 1.234) the number.

Colors

color for empty days — the color used for days without a value (and for values of 0 or less). Default #e8e8e8.

color tiers

This is the core of the heatmap. A tier maps a value range to a color.

Each tier has:

Label — the name shown in the legend and tooltip (e.g. Normal).
Up to — the upper bound of the tier. Leave empty to make it the catch-all tier for every value above the previous bound (shown as ∞).
color — the fill color for days in that range.

How a day is colored: tiers are sorted from low to high. A day’s value is placed in the first tier whose Up to value it does not exceed. The last tier (the one with an empty Up to) covers everything higher.

Example

Label	Up to	color
Very low	5000	light blue
Low	20000	blue
Normal	50000	dark blue
High	80000	orange
Very high	(empty)	red

A day with value 35000 falls into Normal; 120000 falls into Very high.

Use Add tier / Remove to manage the list. When the list gets long it scrolls inside its own area so the property panel stays compact.

Appearance › Style

Language — switches all built-in labels between German and English.
Background Color — the object’s background.
Custom CSS — advanced styling injected for this object.

Tips & troubleshooting

A day looks empty but should have data — check the date format and that the measure returns a value greater than 0 for that day.
All days are the empty color — confirm a dimension and a measure are assigned, and that the selected Year matches your data.
colors don’t match expectations — review the tier Up to bounds; a day always takes the first tier it fits into, from low to high.