Creating a Custom Dashboard

warning

Experimental. This feature may change or be removed.

Custom Dashboards are created in TagoIO Admin in the same place as other dashboards, with a dedicated type tab.

Steps

1. In Admin, click + in the left sidebar (or open the create dashboard flow from your usual entry point).
2. Open the Custom HTML tab.
3. Enter a name and create the dashboard.

This creates an empty Custom Dashboard. You do not pick a widget template, and there is no generate step. The type on the resource is "custom".

What happens next

After create, open the dashboard:

1. Upload HTML from the empty state (or later from the gear menu: Upload new HTML). See HTML shell.
2. Post dashboard:ready and handle theme (and optional style) in your page. See Authoring HTML.
3. Use the postMessage bridge to run saved TagoSQL queries or call Analysis Endpoints.
4. Optionally stream device and entity writes into the page while it is open.

The empty state also expands a short postMessage snippet so authors know the contract before the first upload.

TagoRUN

Run users can open a Custom Dashboard from the TagoRUN sidebar. The view is read-only: TagoRUN shows your uploaded HTML, with no upload, download, or version controls.

Grant access with an Access Management policy whose Target is the Run users:

Permission	Rule	What it does
Dashboard	Access	The dashboard appears in the user's sidebar and opens.
SQL Query	Access	sql.list returns the query to the page.
SQL Query	Execute	sql.run runs the query for this user.
Analysis	Call Endpoint	endpoint.list lists the Endpoint and endpoint.call calls it.
Device	Dashboard access	sql.run with watch lists the device, and stream.open streams it.
Entity	Blueprint access	sql.run with watch lists the entity, and stream.open streams it.

Device permissions do not limit what a Custom Dashboard's queries return. Running a query returns its full result, so filter rows inside the query with session functions. See SQL and Endpoint Bridge in TagoRUN.

Device and entity permissions do gate streams. Besides the two rules in the table, a stream also reaches a device or entity through a widget on a Normal or Blueprint dashboard the Run user has Access to that shows it; watch does not list those. See Live Data in TagoRUN.

Only signed-in Run users can view Custom Dashboards. The Anonymous User sees "This custom HTML dashboard can't be shown here" instead. A dashboard without uploaded HTML shows "This dashboard has no content yet".

Public share and distribute are not supported for this type. If you need them, use a Normal or Blueprint dashboard with Custom Widgets instead.

Compared to other create tabs

Tab	Result
Normal	Widget dashboard bound to fixed devices and variables.
Blueprint	Widget dashboard with tag-based device slots.
Custom HTML	Full-page HTML shell you upload; data through saved queries, Analysis Endpoints, and live streams over postMessage.

For the product overview, see Custom Dashboard.