Skip to main content

Dashboard Overview

A dashboard is where you place your widgets to visualize and interact with data, all in real-time. Dashboards can also be shared with end-users that will access your application using TagoRUN.

All your dashboards are listed on the sidebar of the screen. On the top right you will find the Edit Dashboard menu. From there you will have access to other dashboard functionalities such as rename, share, distribute, duplicate, and delete. Share and distribute apply to Normal and Blueprint dashboards.

Dashboard types include:

  • Normal (Widget Dashboard in the create dialog): create a dashboard for pre-selected devices and variables on a widget grid.
  • Blueprint (Widget Dashboard in the create dialog): associate tags so one layout scales across many devices and users.
  • AI Dashboard (AI Generated in the create dialog): generate a full-page layout from a natural language prompt and refine it with more prompts in the prompt bar or the AI Chat. Run users view it in TagoRUN and can have a personal dashboard.
  • Custom Dashboard (Custom HTML in the create dialog): upload your own full-page HTML shell, which runs saved TagoSQL queries or calls Analysis Endpoints over postMessage. Run users view it in TagoRUN.
TypeSupports
NormalWidgets and templates, share public, distribute, Embed
BlueprintWidgets and templates, share public, distribute, Embed
AI DashboardGenerating and refining the layout with prompts, personal dashboards
Custom DashboardSaved TagoSQL queries, Analysis Endpoints, live streams
info

There is a limit of 100 widgets per Normal or Blueprint dashboard. Types that present a full-page layout instead of the widget grid are not subject to that limit.

About each type​

Normal​

A Normal dashboard is a grid of widgets, each bound to the devices and variables you pick while you build it. It fits a fixed set of devices, such as one site or one machine, and you can start from a template with mock data. To show other devices, you edit the widgets.

A Normal dashboard for an office floor with temperature, humidity, CO2, and occupancy cards, a temperature chart, HVAC status, and CO2 and power charts

Blueprint​

A Blueprint dashboard uses the same widget grid, but its widgets read from device slots instead of fixed devices. Viewers pick the device from a list at the top of the dashboard, so one layout serves many devices, sites, or customers, including devices you add later. Slots find devices by tag, so devices that share a slot need matching tags and variable names.

A Blueprint dashboard for a refrigerated fleet with Depot and Truck pickers at the top and the Truck list open, cargo temperature and speed gauges, a cargo temperature chart, a location map, and door, ETA, and depot cards

tip

You can also change Normal and Blueprint dashboards with TagoAI. Open TagoAI with the AI button in the dashboard header and, in TagoAI's Edit Mode, ask it to add or restyle widgets or add a Blueprint slot.

AI Dashboard​

An AI Dashboard has no widget grid. You describe what you want in the prompt bar or in the AI Chat, which the AI button in the dashboard header opens. TagoAI builds a full-page layout from your devices' data, and you refine it with more prompts in either one. Its data updates on its own when the devices receive data. Run users view it in TagoRUN, and a Run user with AI dashboard generation can change it with a prompt, which creates their own personal dashboard. It needs AI on for the profile.

An AI Dashboard for a solar site with power, battery, and CO2 cards, solar and battery charts, and a request typed in the prompt bar

Custom Dashboard​

A Custom Dashboard is a full page you write in HTML, CSS, and JavaScript, or have an AI tool write, and upload as a single file. The page requests data from Admin or TagoRUN over postMessage: it runs saved TagoSQL queries, calls Analysis Endpoints, and can stream device and entity writes live. There is no in-app editor, so you edit the file and upload it again.

A Custom Dashboard showing a water treatment process diagram with live readings, a 24-hour chart, and an events list

Building dashboards​

To create a new dashboard, start by clicking the + button on the left side of Admin page. A new window will appear with a card for each dashboard type available to your profile: Widget Dashboard, AI Generated, and Custom HTML. You can also start from a pre-designed template where templates apply.

Enter a name for your new dashboard and click a card. Widget Dashboard then asks for Normal or Blueprint and a template, and a blank Blueprint adds a step for its Blueprint Devices & Entities. AI Generated and Custom HTML show what happens after you create the dashboard. Click Create to finish. For Normal and Blueprint dashboards, you can then begin adding Widgets. For AI Dashboard, use the prompt bar or the AI Chat to generate the layout. For Custom Dashboard, upload your HTML shell.

Create Dashboard first step with the name field and the Widget Dashboard, AI Generated, and Custom HTML cards

Dashboard Icons​

You can add icons to your dashboard, making it look just the way that you want it.

Dashboard icons

Dashboard Background​

You can also edit the background color of the dashboards, or add images and animations. Click on the cog icon to edit the configurations inside the 'General information' tab.

Dashboard background settings

Although video formats are not accepted, you can upload animations using the .gif format as shown below. Images can be uploaded into your Files.

Tip: You have full control of the opacity level for the background and the widgets.

Reordering widgets for mobile app on TagoRUN​

When accessing dashboards through the TagoRUN app, widgets appear in the sequence of their creation by default. To modify this arrangement, simply switch your dashboard to Edit mode and click on the small smartphone icon located at right top corner.

To reorder the widgets for the mobile app, just drag them to your preferred position. The adjustments will take effect immediately, although you might need to refresh the dashboard on the mobile app to see the changes.