Multi-Parameter Aggregation Card

Who it’s for

Dashboard builders reach for this widget when they need one compact card that summarizes several related parameters over a time window, not just each one’s instantaneous latest value. They ask questions like “how do I show average consumption over the last hour next to a device’s current status?”, “is there a simple card that aggregates numeric telemetry but still shows the latest state for a boolean or string key?”, or “how do I get a multi-parameter summary card without building a full chart?”

What it does

A card configured with three keys can show 1,240 kWh as the AVG-aggregated value of an energyConsumption key, Running as the most recent value of a status string key, and 2 d 4 h as an AVG-aggregated uptime key run through the time formatter. Each key renders as its own row inside a single card.

• Numeric keys are aggregated over the widget’s selected time window, using SUM, AVG, MIN, MAX, or COUNT — set per key, with a widget-wide default as fallback.
• A time formatter turns a raw duration into readable text (seconds, minutes, hours, or days), so a number like 7500 can read as 2 h 5 m instead of a bare count of seconds.
• String and boolean keys skip aggregation and instead show either the Latest value by timestamp or the value seen most often in the window (Most occurrences).
• Each row can carry an icon, a label, a unit, and a relative “last updated” time (e.g. “a minute ago”), with the icon’s color and background either fixed or driven by a value function.
• The card’s time-window indicator (e.g. “Realtime – last 1 day”) always shows the range the aggregated values cover, so the scope behind the numbers is never a guess.
• Summarizes existing keys as numbers and states; it does not chart history or trends — pair it with a chart widget when a trend line is what’s needed.

How to set up

Data keys

Key	Role	Type	Description
Data keys (user-configured, any number)	One row per key	Timeseries or Attribute	Numeric keys are aggregated; string or boolean keys show one representative value instead

A demo configuration with sample keys ships by default, so the card renders as soon as it’s dropped on a dashboard. With no data keys configured, it shows a “No data keys configured” placeholder instead of an empty layout.

Aggregation

Setting	Default	Effect
Aggregation (per key, Data Keys tab)	DEFAULT	Reuses that key’s own Appearance-tab aggregation, or the widget-wide default if that isn’t set; SUM, AVG, MIN, MAX, or COUNT overrides it
Default aggregation (Appearance tab)	—	Fallback used by any key left on DEFAULT
Aggregation set to NONE	—	Switches that key from numeric aggregation to the Latest / Most-occurrences strategy — required for string and boolean keys
Approach for non-numeric values	Latest	Choose Latest (most recent value) or Most occurrences (value seen most often in the window); applies to keys with Aggregation set to NONE

Pick a time window for the widget (Realtime or History) — every numeric key aggregates over that same range automatically.

How to customize

• To show a duration-style number as readable time — enable Use time formatter on that key, choose which units to include (seconds through years), and pick a label style (short/long, lower/upper case) under Time units format.
• To set a row’s label, unit, or icon — edit them on the Data Keys tab.
• To color a value or icon based on its current number — set that color to Function mode and provide a value → color script.
• To hide the “last updated” line — turn off Display update time.
• To add separators between rows — enable Display divider between items.
• To change typography — adjust Value font, Secondary font, or Update time font under Style.

Tips

• Leave a key’s Aggregation on DEFAULT and set the aggregation once on the Appearance tab when every numeric key should summarize the same way; override individual keys only where they need to differ.
• Set Aggregation to NONE before picking Latest or Most occurrences — the non-numeric strategy only applies once a key is out of the numeric aggregation path.