Documentation menu

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.

Creating and embedding

Widgets live under your site's Settings, in the Widgets tab: pick the metric and the window, and copy the snippet. It is a plain iframe:

anywhere that renders HTML
<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.
  • The preview dialog in the dashboard shows the exact live document before you embed it.

Whose clock a widget reads

A widget's window (Today, Last 7 days) is cut server-side in the site's reporting timezone, set on the same Widgets tab. Not set, windows resolve in UTC. This is deliberate: a public widget cannot ask each reader for a timezone, so the site declares one. The whole clock story is on the timezones page.