Free on all plans

Uptime badges for your
README and docs.

Show the world your services are up. Embed real-time uptime, status, and response time badges anywhere.

One line of Markdown. Updates automatically. Works with GitHub, GitLab, Bitbucket,
Notion, documentation sites, and any website that supports image embeds.

Get your badge free → See badge types

Live examples

| | |

Four badge types

Pick the one that fits your use case. Or use all four.

Uptime percentage

Shows your 30-day uptime percentage. Green above 99%, yellow 95-99%, red below 95%.

Current status

Shows whether your endpoint is operational, down, or pending. Updates within minutes.

Response time

Shows your average response time over the last 24 hours. Green under 500ms, yellow under 1s, red above.

Powered by

A branding badge that shows your service is monitored by UptimeSignal. No monitor ID needed — works instantly.

Add a badge in 30 seconds

Three steps. No build process. No dependencies.

Create a monitor

Copy the embed code

Open any monitor and click "Badge" to get Markdown, HTML, or a direct image URL.

Markdown (GitHub, GitLab, Bitbucket)

                                    [![Uptime](https://api.uptimesignal.io/badge/YOUR_ID/uptime.svg)](https://uptimesignal.io/badges)
                                

HTML (websites, docs)

                                    <a href="https://uptimesignal.io/badges"><img src="https://api.uptimesignal.io/badge/YOUR_ID/uptime.svg" alt="Uptime"></a>
                                

"Powered by" badge (no monitor needed)

                                    [![Monitored by UptimeSignal](https://api.uptimesignal.io/badge/powered-by.svg)](https://uptimesignal.io/badges)
                                

Paste and commit

Add the code to your README.md, docs site, or landing page. The badge updates automatically — no maintenance required.

Where to embed badges

Every badge is a signal that your service is reliable.

GitHub README

Show uptime alongside your build and coverage badges.

Documentation

GitBook, Docusaurus, ReadTheDocs, MkDocs, Notion.

Landing pages

Add to your footer or status section for social proof.

GitLab & Bitbucket

Same Markdown format works across all Git platforms.

Status pages

Complement your status page with inline badges elsewhere.

Email signatures

Use the image URL in your email signature HTML.

Frequently asked questions

How do I add an uptime badge to my GitHub README?

Create a free UptimeSignal account, add your endpoint as a monitor, then click "Badge" on the monitor detail page. Copy the Markdown embed code, paste it into your README.md, and commit. The badge updates automatically every 5 minutes.

Do badges work on GitLab, Bitbucket, and other platforms?

Yes. UptimeSignal badges are standard SVG images served over HTTPS. They work anywhere you can embed an image — GitHub, GitLab, Bitbucket, Notion, Confluence, documentation sites, personal websites, and more.

Are uptime badges free?

Yes. Uptime badges are included free on all plans, including the free tier. You get up to 25 monitors with badges on the free plan, and unlimited on Pro ($15/mo).

How often do badges update?

Badge data is cached for 5 minutes. Combined with your monitor's check interval (5 minutes on Free, 1 minute on Pro), badges reflect near real-time status.

Does the badge expose my endpoint URL?

No. Badges only show the monitor name, uptime percentage, status, or response time. Your endpoint URL is never exposed publicly through the badge.

Can I disable the badge for a specific monitor?

Yes. Each monitor has a "Public Badge" toggle in its advanced settings. Disable it and the badge endpoint returns a generic "disabled" response instead of real data.

What's the "Powered by" badge?

The "Powered by" badge is a static branding badge that says "monitored by UptimeSignal". It doesn't require a monitor ID — anyone can embed it immediately. It's useful for landing pages and footers where you want to show your service is being monitored without exposing specific metrics.

Get your uptime badge

Create a free account, add a monitor, and embed your badge in under a minute.

Start monitoring free →

Uptime badges for your README and docs.