Skip to content

Heatmap

The Heatmap layer shows where people actually spend time and move through the room, drawn straight onto the live grid.

Live overview grid with the heatmap layer enabled, showing warm-coloured cells over frequently-occupied areas.

Turning it on

A Heatmap toggle sits alongside the live overview and the zone editor. Switch it on to overlay the grid with colour; switch it off to go back to the plain grid. The setting is remembered per device, so you don't have to re-enable it every time you open the panel.

What it shows

  • Warmer cells = more time spent there. Cells build up colour — from a faint amber through to orange and red — the more a tracked target dwells or passes over them. Cells nobody visits stay uncoloured.
  • It builds up gradually. A single visit barely registers; a spot people use every day (a favourite chair, a doorway, a desk) grows warmer over roughly the next two weeks.
  • It fades on its own. Old activity fades out over about the same two-week span, so the heatmap reflects recent living patterns, not a permanent record of everywhere anyone has ever stood.
  • Live movement trails. While the layer is on, you'll also see short lines trailing behind each tracked target, showing where it's been moving over the last few seconds. Trails are just a live visual aid — unlike the heat colouring, they aren't recorded or remembered.

Where the data lives

The heatmap is built and stored on the device itself, not in Home Assistant. It keeps building in the background whether or not the layer is switched on — turning the layer on just starts streaming the picture to your screen. It also survives a device reboot, so you won't lose weeks of build-up over a power cut.

Requirements

The Heatmap layer needs firmware 1.3.0 or newer. If your device is on older firmware, the toggle is disabled with a note to update — see Firmware upgrades.

A small number of device variants don't have enough memory to run the heatmap feature at all. If that's the case, the toggle is disabled with a note that it's unavailable on that device — there's nothing to fix.

Where to next