Creating your first dashboard
Every device has its own dashboard. It starts empty — you decide what goes on it.
Open it by clicking the device card, or the chart button on the card.
Rows, columns, elements
A dashboard is built from the outside in:
Rows stack down the page. Columns sit side by side within a row. Each column holds one element — a graph, a gauge, a button. Use several narrow columns for small readouts, or one wide column for a graph.
Building it
Everything happens through the round button at the bottom right.
- Press it and choose Edit. The dashboard switches to edit mode.
- Add a row.
- Add a column to that row, then click it to open the element picker.
- Pick an element type from the list on the left, set it up, and add it.
- Repeat until the dashboard looks right.
- Press the button again and choose Save.
Save before you leave
Changes aren’t kept until you press Save. Navigating away in edit mode loses them.
Clicking an element you’ve already placed reopens the same dialog so you can change or remove it.
Choosing an element
Most elements ask for an entity — one of the values your device reports. See Entities if that list is empty or missing something.
| To show… | Use |
|---|---|
| A number or some text | Text |
| A value over time | Graph |
| Several values side by side | Bar graph |
| A dial-style reading | Gauge |
| Something to switch on and off | Switch |
| A number to set within a range | Slider |
| A one-shot action | Button |
| A free-form command | Command |
| Something on a repeat | Timer |
Every element’s settings also end with an Admin only checkbox, which keeps it off the dashboard of anyone you’ve shared the device with — see Admin-only elements.
Export and import
Export Dashboard downloads the layout as a file. Import Dashboard applies one to the device you’re looking at.
This is the fastest way to set up a second device of the same kind: build one dashboard, export it, then import it onto the others. The elements refer to entities by name, so it works as long as the other device reports the same names.
History
History shows the device’s past values rather than the live view — useful for looking back at what happened without adding a graph for it.
The Debug tab
Next to Dashboard at the top of the page is a Debug tab, which shows debug messages coming from the device. Most of the time you can ignore it; it’s there when a device is misbehaving and you want to see what it’s reporting.