New: the AI firewall watches every module and explains each incident in plain words. See how it works

Widgets

The catalogue of every built-in widget by category, what each one needs as data, the settings every card shares, and how to add one to a board.

A widget is the kind of card you place on a board. Hermetry ships a catalogue of built-in widgets, the IoT modules add their own, and your organisation can create more (see Your own widgets). This page lists them all and explains the settings every card has. The pages under Card types describe each family in depth.

The catalogue

The Add widget picker has the tabs All, Favorites and My widgets, a search box (Search widgets…) and the categories below. Star a widget with Add to favorites to find it again.

Charts

WidgetDrawsData it needsPage
Line chartOne or more series over time as linesA series (up to 8 sources)Chart cards
Bar chartSeries as bars, or one bar per row of a tableA series, or a tableChart cards
Area chartSeries as filled areas, stacked or notA seriesChart cards
Pie chartA table (label, value) as slices or a donutA tableChart cards
Scatter chartA table (x, y, optional group) as points, with a trend lineA tableChart cards
HistogramThe distribution of one numeric column in binsA tableChart cards
HeatmapA table (x, y, value) as a colour grid, for example hour by weekdayA tableChart cards

Data

WidgetShowsData it needsPage
StatOne number with a label, an icon, colour ranges and an optional comparisonA valueValue cards
Stat with trendThe latest value of a series, its change and a trend lineA seriesValue cards
GaugeOne number on a half circle, a donut, a bar or a levelA valueValue cards
ProgressA number against a target, as a bar, a ring or a half ringA valueValue cards
StateA value mapped to a labelled, coloured state or a lampA valueValue cards
AttributesA record as a label and value listA recordValue cards
TableRows and columns with sorting, search, paging and downloadA tableTables and lists
Activity feedEvents in time order with a severity colourA tableTables and lists
MapRows with coordinates as markers, zones and routes, on a map or a floor planA tableMap cards

Content

WidgetShowsPage
TextMarkdown text, optionally with values of a record and board parametersContent cards
ImageA picture with a caption and a linkContent cards
Quick linksA list, cards, tiles or buttons that open pagesContent cards
EmbedAn outside https page in a sandboxed frame, from the allowed sites onlyContent cards
Video playerA video file or a live stream (HLS)Content cards

Controls

WidgetDoesPage
ButtonRuns actions or a command when pressed; can be a toggleControl cards
SwitchReads an on/off value and sends a command when toggledControl cards
SliderReads a number and sends the new one on releaseControl cards
Set pointA number input with Apply, a stepper or a dialControl cards
FormSeveral fields saved together with one commandControl cards

IoT

WidgetShowsPage
Device tableYour devices with their live connection stateTables and lists
Alarm tableAlarms with severity and status, liveTables and lists
RulesThe Rules card of a site or a deviceThe Rules card

Process & SCADA and 3D

WidgetShowsPage
Process diagramA 2D process drawing whose symbols follow live valuesSCADA
Process symbolOne process symbol (a tank, a pump, a valve) driven by a valueSCADA
Design, live (3D)A stored 3D design whose items follow live values3D views
3D modelA published IFC model with sensor markers3D views

These four appear only when your organisation uses the SCADA and 3D modules of the IoT add-on. When a module is turned off, its cards stay on the boards, keep their settings and show a “Widget not available” card (“This widget is no longer available — its module may be disabled, or you may no longer have access.”). Turn the module on again and they draw as before.

Add a card

  1. Open the board and select Customise.
  2. Select Add widget and pick a widget.
  3. In the settings drawer, open the Data tab and choose where the values come from. Until then the card says, for example, “Bind a data series in this widget’s settings.” See Data sources and parameters.
  4. Set the Title. A title may show a parameter with {{param_<key>}}, for example Pump {{param_device}}, which reads as the chosen device’s name.
  5. Select Save. Then select Done to leave Customise.

The settings drawer

The drawer has tabs. Which tabs show depends on the widget.

TabHolds
CardTitle, subtitle, title icon, help text, card style (Raised, Flat, Outline, No frame), inner spacing, background, card buttons, small screens
DataThe data sources of each slot, the time window, the refresh interval, what to show with no data or old data, the script (under Advanced: compute the values with a script)
DisplayThe widget’s own look: series, axes, ranges, layout, colours
BehaviourWhat happens on a click (actions), control feedback texts

Settings marked advanced are hidden under Advanced settings. The drawer’s Save keeps the card; Cancel asks “Discard unsaved changes?” when you changed something. Save as widget… saves the card as a reusable widget in your library.

Settings every card has

SettingValuesDefault
Card buttonsFull screen, Download data (CSV), Refresh nowFull screen for cards with data. With CSV on, an Excel button appears beside it.
Refresh every (seconds)A number, or OffThe board’s Refresh every (seconds), else none
When there is no dataYour text“No data”
Show last updateOff, “2 min ago”, a time, a date, date and timeOff
Data is old after (seconds)0 to 604,800; 0 = never0
When data is oldShow an “Old data” badge, Fade the card and show the badge, Show the no-data messageBadge
Show the time window on the cardLets viewers pick a window for this card only (never saved)Off
Hide on small screens, Hide on large screens, Order on small screens, Height on small screens (px)Phone layoutOff, grid order, automatic

Number values also have a Value format: Unit, Decimals (0 to 10), Unit position and Large numbers (1,250,000 or 1.25M).

Troubleshooting

The card saysDo this
“This card is not finished: choose its … in its settings.”A required data field is empty. Open the settings and fill it.
“Choose a value in the filters above to load this widget.”The card follows a parameter that has no value yet. Pick one in the filter bar.
“You may not see the data of this card.”You lack the read permission for that data. Ask an administrator.
“Not refreshed”Too many requests: the card shows the last data and asks again shortly.
“Widget not available”Its module is off or you lost access. Remove from board removes the card.

More causes: A dashboard shows no data.