Floor Plan Map Widget
Your own building plan, site drawing, or process diagram as a live dashboard canvas. Upload an image, drop pins on it, and each pin shows a device's latest reading, a gateway's online state, or a shortcut to another dashboard. Viewers can zoom and pan the plan and click any pin for detail.
What it shows
The widget renders your uploaded image with up to 100 pins placed on it. Three kinds of pin:
- Device pin - bound to a device. Shows a live reading, an icon, or a colored dot, and flashes when the device has an active alert (see Alert flash below).
- Gateway pin - bound to a gateway. Colored by online state: green when the gateway has reported within the last 15 minutes, red when it hasn't (a gateway down is an incident on a floor plan, so offline is loud on purpose).
- Navigation pin - a labeled shortcut that jumps the viewer to another dashboard (optionally a specific tab). Useful for "Floor 2 ->" style drill-downs between plans.
Readings refresh on their own roughly once a minute. Clicking a device or gateway pin opens a popover with the primary reading, any secondary fields, and a link to the device or gateway page.
Alert flash
When a device on the plan has an active alert, its pin radiates expanding rings (like a sonar ping) and gains a corner badge, so the alarm is visible from across the room even on a busy plan:
- Alert level pulses red.
- Warning level pulses amber, at a slightly calmer pace.
- Info level does not flash; the pin stays quiet.
The badge stays on the pin between pulses, so an alerting device is still obvious at a glance on a plan full of pins.
The halo follows the device's rule-driven alert level, the same state the Status widget's Alert state variant shows, set by a workflow's set-device-status action and cleared by acknowledging. See Responding to alerts -> Alert states on a device for how alert states work.
Details worth knowing:
- On by default. Every device pin flashes when its device is alerting. Turn it off per pin with the Alert flash switch in the pin editor (for example, on a plan dedicated to a reading where a separate alarm panel already handles alerts).
- Live. On tiers with live dashboard refresh the halo appears and clears within a second or two of the alert changing; otherwise it updates within a minute.
- Per viewer. The halo respects alert visibility: a customer viewing their own dashboard only sees halos for alarms they are allowed to see.
- Reduced motion. For viewers whose system settings ask for reduced motion, nothing animates: the pin keeps a steady colored ring and the corner badge instead.
The halo is independent of threshold rules: threshold rules color the pin itself from the reading, while the halo signals an active alert from a workflow. A pin can show both at once.
Configuring a Floor Plan Map widget
Basics tab
| Field | What it does |
|---|---|
| Title | Header text (required, max 120 chars). |
| Subtitle | Optional caption. |
Image tab
Upload a PNG or JPEG up to 10 MB. Larger plans are easier to read when zoomed; the widget supports zoom and pan once a background is in place. Fit controls how the background scales when the widget is bigger than the image (contain or cover). Replacing the image keeps your pins where they are, positioned proportionally.
Pins tab
Pick a pin type (Device / Gateway / Navigation), then click the canvas to drop it. Drag pins to reposition. Each pin has its own editor panel:
Device pin
| Field | What it does |
|---|---|
| Device | The bound device (required for live data). |
| Pin style | Value shows the primary reading in a pill; Icon and Dot are color-only. |
| Icon | (Icon and dot styles) glyph from the built-in icon set. |
| Label override | Text under the pin; defaults to the device name. |
| Pin size | Diameter from 20 to 80 px. Dots render smaller, in proportion. |
| Show label | Always-on text rendered under the pin on the canvas. |
| Alert flash | Pulse a colored halo while the device has an active warning or alert. On by default. |
| Primary field | Drives the pin color and the value shown on value pins. |
| Threshold rules | Color the pin by the primary reading (first matching rule wins). |
| Secondary fields | Up to 6 extra fields shown in the click popover, each threshold-colored by its own rules. |
Gateway pin
| Field | What it does |
|---|---|
| Gateway | The bound gateway. |
| Pin style | Icon or dot. Color always reflects online state. |
| Label override / Pin size / Show label | Same as device pins. |
Navigation pin
| Field | What it does |
|---|---|
| Title | The visible label users tap (required, for example "Floor 2"). |
| Icon | Glyph shown on the pin. |
| Target dashboard | The dashboard to open, optionally a specific tab. |
Advanced tab
A read-only view of the widget config, useful for debugging or sharing with support.
Public share links
On a dashboard shared by public link, device and gateway pins render with their live readings and states, including the alert flash (updated about once a minute). Navigation pins are removed, and pin popovers never link into the app.
Tips
- Use Dot pins with threshold rules for a dense plan where dozens of sensors need to read at a glance; switch key sensors to Value pins.
- Pair the alert flash with a Status widget on the same dashboard so viewers can see who acknowledged, and acknowledge, without leaving the page.
- Gateways on the plan give instant "is the infrastructure up" context next to the sensors that depend on them.
When to use a different widget
- For device locations on a real-world map -> the Geo map widget.
- For one reading front and center -> a Value or Gauge widget.
- For an alert indicator with an Acknowledge button -> the Status widget's Alert state variant.