Skip to main content
A status badge is a small image that shows your current status or uptime. Put it in a README, a docs site or your website, and link it to your status page. Badges are available on all plans and are off by default.

Enable the badge

1

Open the Settings tab

Click Status Pages in the sidebar, open a page, and select Settings.
2

Turn on the badge

In the Status badge section, select Enable status badge, then click Save Changes.
3

Copy a snippet

Two badges appear with a live preview. Click Copy next to the Markdown or HTML snippet of the badge you want, and paste it where you want the badge to show.
The badge links to your status page. If you have a verified custom domain, the snippet uses it. Otherwise it uses your UptimeIO subdomain.

Badge types

For the uptime badge you can choose a period of 24 hours, 7 days, 30 days (default) or 90 days. The color follows the uptime thresholds you set in the Settings tab: green at or above the operational threshold, amber at or above the degraded threshold, and red below it.

Example

Replace your-subdomain with your status page subdomain.
The uptime badge takes an optional period of 24h, 7d, 30d or 90d:

When the badge shows

The badge only shows for published, public status pages. If the page is a draft, is password protected, or the badge is turned off, the image reads not found. Publish the page, remove password protection and enable the badge to use it.