Image Widget
Shows a static image on a dashboard tile: a site photo, a floor plan, a wiring diagram, a logo, or any other picture that gives an operator context alongside their live device data. Unlike the data widgets, it does not bind to a device or field; it only needs a picture.
What it shows
A single image, scaled to fill the tile according to the Fit option you choose. You can either upload an image (which we host for you) or point the widget at an image URL you already have online.
Configuring an Image widget
| Field | What it does |
|---|---|
| Title | Header text shown above the image (max 120 chars). |
| Image | The picture to show (required). Upload a file, or paste a direct image link. See Upload or link below. |
| Alt text | A short description read by screen readers, and shown if the image ever fails to load (max 200 chars). Optional but recommended. |
| Fit | How the image scales inside the tile. See Fit options. |
Upload or link
You can supply the image two ways:
- Upload an image (recommended). Choose a PNG or JPEG file up to 10 MB. We host the image for you and serve it securely, so it does not depend on any outside website staying up. This is the most reliable option, and the hosted address is never exposed on the dashboard.
- Paste a direct image URL. Point the widget at an image already hosted somewhere online. The link must be a direct link to the image itself (ending in the picture) and use
http://orhttps://.
Uploading is the more dependable choice. A pasted URL relies on the outside host: if that site blocks hotlinking, moves the file, or goes offline, the tile can show nothing. When an image cannot load, the widget shows a "failed to load" placeholder instead of a blank tile.
To switch a hosted image back to a link, use Remove, then paste a URL.
Fit options
| Option | What it does |
|---|---|
| Contain | Fit the whole image inside the tile with no cropping. Empty space may show around it. |
| Cover | Fill the whole tile, cropping the edges of the image as needed. |
| Fill | Stretch the image to the tile, which may distort it. |
| None | Show the image at its actual size; it may overflow or leave space. |
Contain is the safest default when you want the whole picture visible. Cover works well for backgrounds where some cropping is fine.
Tips
- Use Alt text for anything an operator needs to understand, so the meaning survives even if the image cannot load.
- Image widgets do not bind to device data, so the dashboard time range does not affect them.
- For a floor plan you want to drop live device pins onto, use the Map widget instead of a plain Image.
When to use a different widget
- For a live web page rather than a static picture, use the Embed widget.
- For a clickable link or navigation action, use the Button widget.
- For your own device telemetry, use a data-bound widget: Value, Chart, Gauge, Status, or History.
See the Dashboards overview for how widgets fit together on a dashboard.