Flux Guide ← All widgets
Widget

Text

A free-text label for your dashboard — a heading, a caption, a note. Type any text, style the font, size, weight, color, and alignment, and optionally drop in a linked entity's live value with a token.

What it does

The Text widget shows a block of text you type. It renders as plain styled text — pick the font, size, weight, italic, color, and alignment. If you link an entity to the widget, you can insert tokens that are replaced with that entity's live data, so a label can read something like "Living Room: 72°".

Live tokens When the widget has a linked entity, type {value}, {name}, {unit}, or {state} anywhere in the text and Flux swaps in the entity's current reading. Without a linked entity the text is shown exactly as typed.
Plain text, not Markdown The Text widget renders your text as-is with the chosen font styling. There's no Markdown formatting — bold/italic come from the weight and italic settings, not from ** or *.

Add it

  1. Enter edit mode, tap Add Widget, choose Text.
  2. Open the widget's inspector (tap the widget while editing) and type your text.
  3. Style it — font, size, weight, color, alignment. To show live data, link an entity at the top of the inspector, then tap a token chip ({value}, {name}, {unit}, {state}) to insert it.

Settings

SettingWhat it does
TextThe text to display (multi-line). When the widget has a linked entity, insert {value}, {name}, {unit}, or {state} to show its live data. If left empty, the widget falls back to its title, or the word "Text".
Font sizePoint size, 10–80.
WeightLight, Regular, Medium, Semibold, or Bold.
FontAn installed font family, or System (the default).
StyleWhen using the System font: Default, Rounded, Serif, or Mono. (Hidden once a custom font family is chosen.)
ItalicSlants the text.
AlignLeft, Center, or Right.
Text colorColor of the text. Default follows the theme/system primary color.
Tokens {value} is the formatted reading, {state} is the raw state string, {name} is the entity's friendly name, and {unit} is its unit of measurement. Tokens only resolve when an entity is linked to the widget — otherwise they're shown literally.