Free tools · Status page badge

Status page badges

Show that you're up where people already look: your README, your site's footer, your docs. Live status and uptime badges from your 12happy status page, updated within a minute.

Paste its address from the console (Status pages), or just the last part.

Preview

Enter your status page to see your badge.

No status page yet? Every plan includes one, the free plan too. Set it up in a few minutes.

Start free →

The badge address

Every public status page has badges at this address, where your-page is the last part of the status page's address:

https://www.12hpy.com/badge/your-page.svg

Add any of these to the end, after a ?, joined with &:

  • type=uptime: uptime instead of status.
  • period=7d, 30d or 90d: the uptime period. 30 days if left out.
  • component=API: one component, by the name your status page shows.
  • label=Our%20API: your own text on the left.
  • style=flat-square: square corners.

So https://www.12hpy.com/badge/acme.svg?type=uptime&component=API shows the API's uptime over the last 30 days.

Why put uptime on show

A badge is a small promise kept in public. For an open-source project or an API, it answers "is this maintained, is it up?" before anyone asks. For a client site, it's the agency's work, visible. And when something does go wrong, the badge links to the status page that explains it, which is where you want people to go instead of your inbox.

To see what an uptime figure allows in downtime, use the SLA & uptime calculator.

Questions

What is a status badge?

A small image that shows whether your service is up, or its uptime over the last 30 days, and updates on its own. People put them at the top of a GitHub README, in a site footer or in docs, linked to the full status page.

How often does the badge update?

Within about a minute of a change on your status page. Badges are cached for a minute so that a busy README doesn't load your page on every view. GitHub keeps its own copy of README images and may take a few minutes longer.

What does the badge publish?

Only what your public status page already shows: the overall status, each component's display name, status and uptime. Internal monitor names, URLs, regions and error details are never part of it.

How is the uptime on the badge worked out?

For 90 days it is the same figure your status page shows, from every check in that period. For 7 and 30 days it is the average of the daily uptime, leaving out days with no checks. Without a component, the badge shows the lowest uptime of all the page's components, the same way the page's headline shows its worst component rather than an average. Figures are rounded down, so a badge never says 100% when there was any downtime.

Does it work with a password-protected status page?

No. A badge is public by nature, so for a password-protected or unpublished page it shows "private" or "not found" and nothing else.

Do I need a paid plan?

No. Every 12happy plan includes public status pages, the free plan too, and every public status page gets badges.

A status page worth linking to

12happy checks your sites around the clock, confirms failures from a second location before anything turns red, and keeps your status page up to date on its own.