Heatmap

Updated November 9, 2026

The Heatmap block shows activity over time as a grid of coloured squares, like a contributions calendar. Darker squares mean more entries.

Data

SettingWhat it does
FormThe form to show.
Date fieldWhich date places an entry on the grid: Date Created or a Date field on the form.

Display

SettingChoices
Display modeDates (year), Dates (month), Months (year), Weeks (year), or Days of the week
Date rangeThe current, last or next period, or a Custom range with From and To dates
Week starts onSunday or Monday
Intensity modeCount (frequency): colour by how many entries. Binary (present / absent): any entry colours the square fully.

Colours and cells

SettingWhat it does
Low color / High colorThe colours for empty or quiet cells and for the busiest cells. Cells in between blend the two.
Empty cell opacity (%)How faint empty cells look.
Cell shapeSquare or Circle
Show legendAdds a less-to-more colour key.
Show tooltip on hoverShows the date and count when a visitor points at a cell.
Highlight todayOutlines today’s cell.

Cells are sized to fit the block. In the Style tab, Cell size sets a maximum and Gap the space between cells. The Filter and Visibility tabs work as on other blocks.

Was this page helpful?
Scroll to top