Content cards

Content cards explain and connect: a note for the night shift, a site photo, links to the device pages, an outside status page, a video. Content you type is never run as code: Markdown is rendered as text, links pass a scheme check and outside pages run in a sandboxed frame.

Text

Markdown text: headings, lists, quotes, code, bold, italic and links. HTML is shown as text, never run.

Setting	Values and defaults
Layout	Plain text (default) or Callout box (Info, Success, Warning, Error, Custom, with an icon)
Text (Markdown)	Up to 20,000 characters
Alignment, Vertical position, Text size	Left, top, medium
When the text is longer than the card	Scroll (default) or Cut off after some lines (1 to 40, default 6)
When a field has no value	“—”

Live values in text. Bind the optional Record for {{field}} values slot, for example to Latest values of a device as one record with the keys level,flow. Then write:

## Reservoir

Level: **{{level}} m** · Inflow: {{flow}} l/s

Shown for: {{param_site}}

{{field}} inserts a value of the bound record and {{param_<key>}} a board parameter (not inside code). List record values under the text adds every value as a list.

Clickable words. [Open the pump](action:pump) makes the words a click target. Add an action to When a link in the text is clicked with the element id pump (see Card actions and drill-down).

Image

Setting	Values and defaults
Image address	An internal path (for example an uploaded file /uploads/…) or an https or http address
Alternative text	Describe the image for screen readers. Empty marks it decorative.
Fit	Cover (default), Contain, Stretch, Original size; position; corner radius
Effects	Zoom in on hover, an overlay colour and strength, greyscale, brightness
Caption	Up to 200 characters, on the image (bottom or top), below or above it
Link	An internal path or an https address opened on click

Quick links

Up to 24 links shown as a List, Cards, Tiles or Buttons, in 1 to 6 columns (auto by default). Each link has a Label, a Target, a Description, an Icon and colours. “Targets must be an internal path, https, http or mailto; anything else is dropped.” External links are marked with ↗ unless you turn that off.

Embed

Shows an outside web page in a frame, for example a status page of your network provider.

1. An administrator opens Dashboard Settings and lists the allowed sites under Allowed embed sites: one site per line, status.example.com, or *.example.com for all of its subdomains. “When the list is empty, no page can be embedded.” The list is empty by default.
2. Add an Embed card and set the Page address (https only).

Setting	Values and defaults
Shape	Fill the card, 16:9, 4:3, 1:1
Zoom (%)	25 to 200 (100). Below 100 shows more of the page in a small card.
Show the address bar	On: the site’s name, a hint and a link to open the page in a new tab
Hint	A text that tells viewers why a page may stay blank (some sites forbid framing)
Reload every (seconds)	10 to 86,400, for pages without their own refresh
The page may	Run scripts, Submit forms, Open new windows, Present: switch them off for a stricter frame

The page can never reach Hermetry, its cookies or its storage. Private, loopback and single-label hosts are refused. A card that points at an unlisted site cannot be saved (“This site (…) is not on the allowed embed sites of this workspace”).

Video player

Plays MP4 or WebM files and HLS live streams (.m3u8), from an internal path or an https or http address. A bound value (the Video address slot) takes the place of the typed address, so a card can play the stream address stored on a device.

Setting	Values and defaults
Poster image	Shown before the video plays
Start playing on its own	Off. Browsers allow it only muted.
Start muted, Loop, Hide the controls while playing	Off, off, on
Fit	Whole video (default) or Fill the card; player style
Subtitle tracks	Up to 12 WebVTT files with a label and language code
Ask ‘still watching?’ every	5 (default), 10 or 15 minutes, or Off. With no answer the stream stops loading. All video cards of a board share one question.
Stop the stream when the card is out of view	On. A stream scrolled out of view, or in a hidden tab, stops loading and rejoins the live edge when it comes back.

A second slot, Higher quality address, can carry the address of a higher quality stream of the same source.

Cameras

To show a camera’s live view, bind the Video address slot to One attribute of the device at a position of a set and pick the attribute that holds the camera’s live address. See Cameras on dashboards.

Troubleshooting

The card says	Fix
“Set a page URL in this widget’s settings.”	Enter the Page address.
“This URL cannot be embedded. Use a public https address.”	The address is not https, or points at a private host.
An embed stays blank	The site forbids framing, or it is not on Allowed embed sites. Add a Hint and keep the address bar on.
“Set a valid image URL in this widget’s settings.”	The image address is empty or not allowed.
“Add links in this widget’s settings.”	The links list is empty.