Multi-Parameter Aggregation Card

Who it’s for

For dashboard builders who need one compact card that summarizes several related parameters over a time window — not just their instantaneous latest value. Typical questions this widget answers: “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

Renders any number of configured data keys as a vertical list, one row per key, 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). An optional time formatter converts a raw numeric duration (seconds, minutes, hours, days) into a human-readable string (e.g. 2 d 4 h).
• Non-numeric keys (string or boolean) skip aggregation and instead use a selectable strategy: Latest (most recent value by timestamp) or Most occurrences (the value seen most often in the window) — set aggregation to NONE on that key to enable this.
• Each row can show an icon (with configurable color and background, constant or value-driven via a color function), a label, the computed value with its unit, and a relative “last updated” timestamp (e.g. “a minute ago”).
• A divider between rows and the update-time text can each be toggled on or off.
• The card’s own time-window indicator (e.g. “Realtime – last 1 day”) reflects whatever range is selected for the widget, so the aggregation scope is always visible at a glance.
• With no data keys configured, the card shows a “No data keys configured” placeholder instead of an empty layout.

How to set up

1. Drop the widget on a dashboard and add one or more telemetry data keys. A demo configuration with sample keys is included by default, so the card renders immediately.
2. For each key, set a label, unit, and icon from the Data Keys tab.
3. Pick a time window for the widget (Realtime or History) — numeric keys will aggregate over that range automatically.
4. Leave each key’s Aggregation on DEFAULT to reuse its Appearance-tab aggregation, or pick SUM / AVG / MIN / MAX / COUNT explicitly to override it.
5. For string/boolean keys, set that key’s aggregation to NONE so the widget switches to the Latest / Most occurrences strategy instead of trying to sum or average it.

How to customize

• To change how a numeric key is summarized → set that key’s Aggregation (DEFAULT / SUM / AVG / MIN / MAX / COUNT) in the Data Keys tab. DEFAULT reuses the key’s own Appearance-tab aggregation (falling back to the widget-wide setting if that isn’t set); any other value overrides it.
• To display a string or boolean key by its most recent value instead of its most frequent one (or vice versa) → set the widget’s “Approach for non-numeric values” option, and make sure that key’s aggregation is set to NONE.
• To show a duration-style number (e.g. runtime in seconds) 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 hide the “last updated” line → turn off “Display update time.”
• To add separators between rows → enable “Display divider between items.”
• To color a value or icon based on its current number → set that color to Function mode and provide a value → color script.
• To change typography → adjust Value font, Secondary font, or Update time font under Style.