Flow token card

Display the live value of any Homey flow token or variable.

On this page

Shows the live value of a Homey flow token or variable — better known in Homey as logic variables.

A Flow token card showing a weather value

This is the card that lets you display anything. If you can calculate it in a flow and store it in a variable, you can put it on a dashboard.

What it is for

  • Values Homey computes rather than measures: days until bin collection, cheapest energy hour, car charge level.
  • Text status: Nobody home, Washing machine finished.
  • Numbers pulled from an API by a flow and stored in a variable.

Settings

Setting What it does
Flow token Which token or variable to display
Title The card's heading
Unit Text appended after the value, e.g. °C, kWh, days
Refresh time (seconds) How often to re-read the value
Show icon Show an icon on the card
Show value Show the value itself

Unit

Purely cosmetic — it is appended to whatever the token holds. Handy because a Homey number variable has no unit of its own.

Refresh time

Most tokens update as they change. The refresh interval is a safety net for values that do not announce themselves. Longer is gentler on your Homey; there is rarely a reason to go below a few seconds.

Tips

  • Combine with a gauge. A Gauge card can also take a flow token as its source, if you want the value shown against a range rather than as text.
  • Text tokens work too. The card is not limited to numbers — a text variable displays as text, which makes it good for status messages.
  • Keep titles short. The value is the point; a long title squeezes it.

If the token list is empty

Flow tokens only appear once Homey exposes them. Create the variable in Homey first (Settings → Logic), then reopen the card settings.

Something unclear or out of date? Let us know or ask in the Discord community.