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. Load data through the postMessage SQL bridge: list and run saved TagoSQL queries from the shell.

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

Admin only

Custom Dashboards run in Admin. They are not available in TagoRUN. Public share and distribute are not supported for this type. If you need end-user portals or widget-based sharing, 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 via postMessage SQL bridge (saved queries).

For the product overview, see Custom Dashboard.