Reading your dashboards
A dashboard is a page that turns the data from your devices into something you can scan at a glance: numbers, charts, gauges, and status panels. Your provider builds the dashboards; you read and interact with them.
What you'll see when you sign in
When you sign in, the platform takes you straight to your home dashboard, if you've set one (see Setting your home dashboard below). If you haven't, you land on whichever dashboard you opened most recently, or on the Dashboards list. You can return to the list at any time from Dashboards in the sidebar.
If no dashboards have been set up for you yet, you'll see an empty list. Ask your provider to build the first one.
The shape of a dashboard
Each dashboard is a grid of widgets. Widgets come in several shapes, and each one is bound to a device, a field on that device, or a group of devices:
- Value: a single number with units (for example, Tank level: 72%). The color may change if the reading is outside a normal range. A small caption underneath usually shows when the reading was taken (for example, as of 6/23/2026, 7:54:02 PM); when the number is a total or average over a window rather than the latest reading, the caption tells you which instead (for example, Sum · last 7 days).
- Gauge: a dial, bar, or specialised gauge (battery, signal, compass) showing where a reading sits between a minimum and a maximum.
- Chart: a line, bar, or area chart with one or more readings plotted over time.
- Status: a colored pill that says whether a device is online, whether a particular condition is true, or whether an alert is active.
- State Timeline: horizontal bands showing how a state changed over the selected window, for example motion / no motion in a room, running / stopped hours for a machine, or a device's online / offline history. Hover a band to see when that state started, when it ended, and how long it lasted. A hatched band means the device sent no readings for that stretch.
- Gateways: a list of your gateways showing whether each is online or offline, when it was last heard from, and optionally how much traffic it is handling and its hardware health.
- Count: a large number showing how many devices or gateways currently match a condition, such as offline, alerting, needing attention, or a reading above a threshold. Click the info chip on the tile to see exactly which items are behind the number.
- Table: rows of devices with their latest readings side by side, often with small sparklines. Columns showing a latest reading keep showing the device's last known value even if it hasn't reported within the selected time range, optionally with the value's age, e.g.
(5d ago). - History: a chronological list of a single device's recent readings.
- Map: real-world locations (Geo map) or positions on a floor plan (Floor-plan map), with markers you can click for detail. A Geo map pin can follow the location saved on its device, so a corrected location shows on the map within a minute. A floor-plan pin pulses a red or amber halo while its device has an active alert, so an alarm is visible at a glance; see Responding to alerts.
- Visualization: a chart built in Analytics (Beta), such as a 90-day trend, a ranking of sites, or a heatmap by hour of day. It shows its own period, printed underneath, rather than the dashboard's time range, and refreshes on a schedule. Available when your plan includes Analytics.
- Image and Text: static helpers your provider added for context, such as a site photo or instructions.
- Button: a clickable button that either navigates to another dashboard or sends a command to a device. See Acting on a dashboard.
- Toggle: an on/off (or open/close) switch that sends a command to a device or a group of devices, and can show the current state in color (green on, red off, gray unknown). See Acting on a dashboard.
A dashboard can also be split into tabs across the top. Click a tab name to switch the view.
Choosing the time range
The time-range picker sits at the top right of the dashboard. Pick from Last 15 minutes, 1 hour, 6 hours, 24 hours, 7 days, or 30 days. Every widget on the active tab updates to match.
If a dashboard is set to update live, a small LIVE badge sits next to the picker. New readings stream in without you having to refresh.
If a chart looks empty, widen the time range. The default of 15 minutes is fine for fast-moving sensors but misses readings from devices that only report once an hour or twice a day.
Acting on a dashboard
Most widgets are read-only: you look at them, you don't change them. A few kinds let you act.
Status widgets with an Acknowledge button appear when a device has gone into an alert state. Acknowledging from the dashboard clears the alarm for every viewer and records who did it; inbox notifications are separate and stay until you mark them read. See Responding to alerts for more detail.
Permission required: Operator or Workspace Admin.
Button widgets either navigate to another dashboard (or device page) or send a command to a device. The button label and what it does are set when the dashboard is built; if you're not sure what a button does, ask before pressing.
Permission required: Operator or Workspace Admin. Some buttons that send commands to devices are also limited by your plan; if the button looks faded with a tooltip, it isn't enabled for your workspace.
Toggle switches turn something on or off (or open or closed), like a relay, a light, or a valve. Flipping the switch sends a command to a device or to a group of devices. The color shows the current state: green for on, red for off, gray when it isn't known yet. If you flip it a few times quickly, only the final position is sent. For devices that only check in periodically, the switch may show the change right away while the device catches up on its next check-in.
Permission required: Operator or Workspace Admin, and the same command-sending plan limits as buttons.
Setting your home dashboard
Found a dashboard you want to see first every time you sign in? Make it your home, in whichever way is handiest:
- On the Dashboards list, click the star next to it. A filled star means it is your home; click again to clear.
- Or open the dashboard and use the three-dot menu -> Set as home dashboard. A small Home tag shows while it is yours.
From then on, opening Dashboards takes you straight there. This is your own choice and doesn't affect anyone else. You can also set it under Account settings -> Profile. If the dashboard you chose later becomes unavailable to you, you simply land on the next best one instead.
Reading a chart
Charts show one or more series (each series is one reading from one device) over the time range you've picked.
- Hover over a point to see the exact value and timestamp in a tooltip.
- Click a series name in the legend to hide it. Click again to bring it back.
- If your provider has set threshold lines (for example, a "Warning" line at 80%), they appear as horizontal reference lines so you can see at a glance when readings crossed them.
- Use the download icon (where present) to export the data as CSV.
For charts with many readings, longer time ranges automatically bucket the data, so the chart stays readable instead of becoming a wall of noise.
On phones and tablets
The grid reflows on small screens, so dashboards stay usable on a phone. Widgets stack vertically and resize to fit. Charts and tables remain scrollable.
When a device is not available
A widget says Device not available (or Gateway not available) when the hardware it was set up with is no longer active in your workspace, for example because it was returned or removed. The widget keeps its settings but shows no readings:
- Charts and tables leave the device out. When only some of a chart's devices are affected, the chart still draws the rest and says how many series are not shown.
- Switches, buttons, and set-value controls are disabled, so no command can be sent to the device.
- Map pins turn gray, and their popup says Not available.
- Visualization tiles say Device not available when none of their devices can be shown, or note how many were left out.
- In widget settings, the device is listed as Unavailable device. You can pick another device there.
The widget comes back to life on its own if the same device is made active again. Otherwise ask your provider, or a Workspace Admin who can edit dashboards, to point it at another device.
Frequently asked
Why does a widget say "No data"? Either the device hasn't reported in the current time range, the field isn't being decoded, or the device is offline. Widen the time range first; if it's still empty, check the device on the device list. A widget that says Device not available instead is a different case; see When a device is not available.
Why does a status value (like a valve being open or closed) stay the same across updates? Some values are a state that only changes occasionally, like a valve open or closed, a door, or a relay. The device reports the new state when it changes and then stays quiet, so the widget keeps showing the last reported value until it changes again. That is expected: the tile is telling you the current state, not that a new reading just arrived. The matching tooltip or device events will show when the value was last actually reported.
Can I build my own dashboard? If your plan includes dashboard editing, yes. Workspace Admins can build dashboards, and your provider can also grant Operators that ability. See Building dashboards for the full walkthrough. If editing isn't enabled for your workspace, ask your provider to set up the view you need.
Can I share a dashboard link with a colleague? Yes. Copy the URL from your browser. Anyone you share it with still needs an account in your workspace, and access to that dashboard, to open it (see below).
A colleague mentioned a dashboard I can't find. Why? A Workspace Admin can limit who sees a dashboard, either to specific people or to the members of a particular site. If a dashboard was set up that way and you're not included, it simply won't appear in your list. Ask your admin to add you if you should have it.