Embed a status widget

Embed a floating status widget or an SVG badge on your website, dashboard, or README to surface your status page's real-time uptime.

Get the embed code

1. Open your status page under Status Pages and go to its configuration.
2. Find the Embed section. It shows a single copy-paste script snippet.
3. Click the copy button and paste the snippet into your website's HTML, ideally just before the closing </body> tag.

The snippet looks like this:

<script src="https://howlops.com/embed/status-page/your-slug/script.js"></script>

The script injects a small floating status bar in the bottom-right corner of your page. It shows the current status (All systems operational / Partial outage / Major outage), adapts to light and dark mode, and links back to your full status page.

SVG badge (manual option)

If you prefer a static badge instead of the floating widget, the status page also exposes an SVG badge you can reference directly by URL:

<img src="https://api.howlops.com/api/v1/public/status-pages/your-slug/badge.svg" alt="Status" />

For a Markdown file (such as a GitHub README):

![Status](https://api.howlops.com/api/v1/public/status-pages/your-slug/badge.svg)

FAQ

Does the badge work on GitHub READMEs? Yes. The SVG badge renders in README.md files on GitHub and GitLab.

Does it work on password-protected pages? The embed reflects the public status page, so a password-protected status page will not surface its details through a public embed.

Related

• How-to: Password-protect a status page
• Getting started: First status page