Skip to main content
Category: Display · Renders: custom HTML · Sends commands: no

​
Mental model

An HTML Viewer is an embedded web page. Drop in your own HTML and it renders in a sandboxed frame — an escape hatch for anything the built-in widgets don’t cover.

​
When to use it

  • Custom markup, an embedded widget, a third-party snippet
  • Bespoke display that no standard widget provides

​
Settings

​
General

  • HTML code — the markup to render
  • Sandbox permissions — iframe sandbox flags
  • Show controls — viewer chrome
The HTML runs in a sandbox. Grant only the permissions it needs, and treat any external/embedded content as untrusted.

​
Script API example

The same interactions from a dashboard script: 
// Reveal the embed from a switch elsewhere on the dashboard
widget.on('embedToggle', 'toggle', (on) => on ? widget.show('embed') : widget.hide('embed'));

Widget reference

Prefer a built-in widget when one fits.