Widget

Graph

A configurable history chart. Plot one or many Home Assistant entities over time as a line, area, bar, or scatter chart — with a big live-value readout, a legend, themed axes, and a full-screen view with a 6h / 24h / 3d / 7d time-range picker.

What it does

The graph widget draws the recent state history of numeric entities. Add as many series as you like — each entity becomes its own line (or bar/area/point) with its own color. Flux fetches real history from Home Assistant over the last hours-to-show window, resamples it to a clean curve sized to the tile, and shows a large current-value readout for the first series so the card feels live, not just historical.

Numeric history only A series is plotted from states Flux can read as numbers (temperature, power, humidity, battery, CO₂, and so on). Entities with no numeric history don't draw a line — on the tile Flux falls back to a smooth sample preview, and the full-screen view shows "No history for this range".

Apple Home entities have no history API, so for those Flux graphs the data it has recorded during the current session. Home Assistant entities pull their full stored history.

Add it

Enter edit mode, tap Add Widget, choose Graph.
Open the widget's inspector (tap the widget while editing).
In the Entities section tap Add entity and pick a sensor. Repeat to overlay multiple series on one chart.
Tap the color swatch next to any entity to set that series' color. Swipe a row to delete a series.
Set the chart type, time range, and styling in the sections below.

Multiple series share one chart Every entity you add is drawn on the same plot with a shared Y-axis. The legend (when shown, and there's more than one series) labels each color. The first series drives the big readout.

Full screen

Tap a graph widget at runtime to open the full-screen history view — a large themed chart of every series with a time-range picker in the corner:

6h — last 6 hours
24h — last day (default)
3d — last 3 days
7d — last week

Picking a range re-fetches the history and redraws with a smooth animation. The chart uses smooth (Catmull-Rom) lines and a date-based X-axis, with a legend listing each entity. On iPhone/iPad tap the ✕ to close; on Apple TV the time buttons are focusable with the remote and Menu closes.

Tile vs. full screen The tile honors all your styling options (type, fill, axes, readout, title). The full-screen view always draws every series as smooth lines for the chosen range — it's the "zoom in on the data" view.

Settings

From the inspector (defaults shown in parentheses):

Option	What it does
Type	Line (default), Area, Bar, or Scatter. Bar charts anchor the Y-axis at zero.
Time range	How many hours of history to show on the tile (default `24`h; range 1–336h, i.e. up to 14 days).
Smooth curve	Rounds line/area curves (Catmull-Rom) instead of straight segments (on).
Gradient fill	Adds a soft gradient under a line chart (on). Area charts are always filled.
Point markers	Draws a dot at each sample on line charts (off).
Line width	Stroke thickness for line/area marks (default `2.5`; range 1–8).
Show axes	Master toggle for the axis labels and ticks (on). Off = a clean sparkline.
X axis / Y axis	Show each axis independently (both on).
Gridlines	Faint grid behind the chart (on).
Y-axis ticks	Roughly how many Y labels to show (default `4`; range 2–8).
Label size	Axis text size in points (default `10`; range 7–16).
Custom axis color	Override the axis/grid color (default follows the theme's secondary color).
Manual Y-range	Pin the Y-axis to a fixed Min and Max instead of auto-fitting the data (off — Flux pads the data range automatically).
Title position	Top (default), Bottom, or Hidden. The title text comes from the widget's title (or the first series' name if blank).
Title alignment	Leading (default), Center, or Trailing.
Title size	Title text size in points (default `13`; range 9–28).
Title weight	Regular, Medium, Semibold (default), or Bold.
Custom title color	Override the title color (default follows the theme).
Value readout	The big live current-value number for the first series (on).
Readout position	Leading (default), Trailing, or Hidden.
Legend	Color key for the series, shown when more than one entity is plotted (on).
Legend position	Top or Bottom (default).
Entities	The list of series. Add an entity, set its per-series color, swipe to remove.

Short tiles adapt When a graph tile is under ~160pt tall, Flux switches to a compact one-line header (title plus the live value) so the readout never collides with the chart. The big readout, legend, and bottom title are reserved for taller tiles.

Per-series colors If you don't set a color, the first series uses your page's accent color and the rest cycle through a built-in palette (blue, orange, green, purple, pink, teal, yellow). The full-screen view always uses that palette regardless of per-series colors.