Creating a Custom Dashboard

warning

Experimental. This feature may change or be removed.

Custom Dashboards are created in TagoIO Admin 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. Optionally bind one data source: a saved TagoSQL query or a GET URL template. See Data sources.
3. Post dashboard:ready and handle host messages in your page. See Authoring HTML.

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; optional one data source.

For the product overview, see Custom Dashboard.