Embed a live status badge

The status-page editor offers an embeddable badge for enabled listed public pages on Max workspaces while the status-badges capability is enabled.

The editor reveals one opaque 16-character badge key for the page. The key stays stable when the page title or slug changes.

Copy the read-only loader snippet from the editor and paste it into your website. The loader is served from https://badge.niceuptime.com/v1.js and creates the cross-origin badge iframe.

The rendered badge document has no script, font, image, form, cookie, or browser-side API request. The loader refreshes the iframe every 60 seconds.

The editor lets you choose dot, pill, shield, or card styling, light or dark theme, and whether to show trailing 90-day uptime.

The HTML and SVG URLs are also available when a site needs a direct resource.

The API projection is five bounded fields: title, overall state, status URL, uptime, and uptime window. Every projection response is no-store.

Only enabled listed public pages on live Max tenants return a projection. Private, unlisted, disabled, non-Max, flag-off, deleted, and missing pages fail closed.

The Worker never forwards visitor cookies or authorization headers to the API.

If the badge says Status unavailable, confirm that the page is enabled and listed public, then reload the badge URL.

Deleted pages, deleted workspaces, missing pages, and temporary upstream failures also use the neutral unavailable document so they do not reveal customer data.