Embed a status widget
Drop a tiny live status badge into your own site, docs, or admin dashboard with a single iframe.
Every public status page on LiveStatus also ships as an embeddable mini widget. It is a single iframe, about the size of a button, that always shows the current overall status of your services and a link back to your full status page. Great for marketing sites, customer dashboards, internal tools, and docs.
Copy-paste snippet
Replace your-slug with the slug of your status page.
<iframe
src="https://livestatus.dev/embed/your-slug"
width="320"
height="80"
frameborder="0"
scrolling="no"
style="border:0;overflow:hidden"
title="Live service status"
></iframe>
That is the whole integration. The widget auto-refreshes every 60 seconds without reloading the iframe, so customers on your page see incidents update in place.
Options
The embed URL accepts two query parameters. Both are optional.
| Param | Values | Default | What it does |
|---|---|---|---|
theme | dark, light | dark | Picks the colour palette. Use light on white backgrounds. |
compact | 1, true | off | Hides the page title and timestamp, shows just the pill. |
Examples
Light theme:
<iframe
src="https://livestatus.dev/embed/your-slug?theme=light"
width="320" height="80" frameborder="0" style="border:0"></iframe>
Compact pill (fits in a nav bar):
<iframe
src="https://livestatus.dev/embed/your-slug?compact=1&theme=light"
width="220" height="40" frameborder="0" style="border:0"></iframe>
Framing and security
The /embed/* route sends Content-Security-Policy: frame-ancestors * and X-Frame-Options: ALLOWALL, so it works in an iframe from any origin. The rest of the LiveStatus surface (dashboard, marketing, etc.) is locked down to same-origin framing, so you cannot accidentally embed the whole app.
Finding the snippet in-app
Your page settings screen has a copy-paste card with the correct slug prefilled:
- Open the dashboard and pick the status page you want to embed.
- Click Settings in the top right.
- Scroll to the Embed widget card.
- Click Copy and paste into your site.
No JavaScript fallback
If JavaScript is disabled in the visitor's browser, the widget still renders correctly on first paint — the server renders the current status into the HTML. It simply will not auto-refresh until the page is reloaded.