Documentation

Widgets

Publish one number as a live iframe you can embed anywhere, no account needed to view.

What a widget is

One of your site's numbers, live visitors, or a stat over a window like Today or Last 7 days, published as a small live document you can put in an iframe anywhere: a README rendered as HTML, a status page, your own marketing site. Viewers need no account; the widget has its own public token, separate from everything else.

Create and embed one

Pick the metric and the window

DashboardSiteSettingsWidgets

Widgets live under your site's Settings, in the Widgets tab. Choose the number (live visitors, or a stat over a window) and the window it covers.

Preview the exact document

The preview dialog shows the exact live document before you embed it, so what you paste is what you already saw.

Copy the iframe and paste it in

It is a plain iframe; drop it anywhere that renders HTML:

anywhere that renders HTMLhtml
<iframe
  src="https://api.getopen.so/embed/WIDGET_ID"
  title="Analytics widget"
  width="100%"
  height="320"
  loading="lazy"
  style="border:0;color-scheme:normal"
></iframe>
  • The document draws its own card and adapts to light and dark; the transparent corners show your page, not a white box.
  • Disabling a widget makes its document answer 404 for every reader; re-enabling brings it back at the same address.

Whose clock a widget reads

The site's reporting timezone, not the reader's

A widget's window (Today, Last 7 days) is cut server-side in the site's reporting timezone, set under Site Settings → General. Every site has one. This is deliberate: a public widget cannot ask each reader for a timezone, so it reads the site's. The whole clock story is on the timezones page.

Common questions