Insight graph card

Plot Homey Insights history over time.

On this page

Plots Homey Insights — the history Homey keeps for your devices — as a line graph.

An Insight graph card plotting a value over time

What you need first

Insights must be enabled for the capability in Homey. If a device does not appear in the list, Homey is not logging it: turn Insights on for that device in the Homey app, wait for some data to accumulate, then come back.

Settings

Setting What it does
Insights Which insight(s) to plot. More than one can be added to the same graph
Resolution The time window: last hour, last day, last week, and so on
Title The card's heading
Y min Fix the bottom of the vertical axis
Y max Fix the top of the vertical axis

Multiple insights on one graph

Add several and they are drawn together. This is where the card earns its place — indoor and outdoor temperature on one graph tells you something neither line tells you alone.

Only combine things with comparable scales. Temperature and power consumption on the same axis makes one of them a flat line.

Showing and hiding lines

With more than one insight, a legend appears under the graph (when the card is tall enough). Tap an entry to hide that line, and tap it again to bring it back. Hidden entries stay in the legend, outlined and struck through. The vertical axis rescales to the lines that are left, so hiding a large value brings out the detail in the smaller ones.

Hiding is temporary: reloading the dashboard shows every line again. To remove a line for good, take it out of Insights in the card settings.

Reading exact values

Tap the card to open the graph full screen. There, touch the graph (or hover with a mouse) to see every line's value at that moment, with the time on top.

Y min and Y max

Leave both empty and the graph scales itself to the data. That maximises detail but means the axis shifts as values change, which can make a stable value look dramatic.

Set them for a fixed axis. For indoor temperature, 15 to 25 keeps normal variation looking normal.

Resolution

Shorter windows show detail; longer windows show trends. Note that a long window over a busy sensor is more data for your Homey to send — if a graph is slow to appear, a shorter resolution is the first thing to try.

Tips

  • Give it width. Graphs need horizontal space. A full-width card is usually right; a small square graph is unreadable.
  • Pair it with a gauge. A Gauge for now, a graph for the trend.
  • Energy. Plotting measure_power over the last day is one of the most useful cards you can make — it shows exactly when the house draws its electricity.
Something unclear or out of date? Let us know or ask in the Discord community.