Using the SVG Status Badge
The SVG badge is a simple, lightweight way to show your current status. It’s perfect for README files, documentation, and anywhere you need a simple indicator.

What Is the SVG Badge?
The SVG badge is a small image that:
- Shows your current overall status
- Updates automatically
- Requires no JavaScript
- Works anywhere images work
It looks like:
Getting the Badge URL
- Go to Status Pages > Embeds / Widgets
- Find the SVG Badge section
- Copy the image URL
Your badge URL looks like:
https://statuspage.me/badge/your-slug.svg
Using in HTML
Add the badge to any webpage:
<img
alt="Status"
src="https://statuspage.me/badge/your-slug.svg"
/>
Using in Markdown
Perfect for GitHub, GitLab, or documentation:
Badge Only

Badge with Link
[](https://your-slug.statuspage.me)
This makes the badge clickable, linking to your full status page.
Common Uses
| Location | Example |
|---|---|
| GitHub README | Show project status at the top |
| Documentation | Indicate service availability |
| Email signatures | Quick status check for customers |
| Dashboards | Lightweight status indicator |
Badge States
The badge automatically reflects your status:
| Status | Color |
|---|---|
| Operational | Green |
| Degraded Performance | Yellow |
| Partial Outage | Orange |
| Major Outage | Red |
| Maintenance | Blue |
Caching
The badge is cached for performance:
- Updates within a few minutes of status changes
- Reduces load on your status page
- Ensures fast loading on your site
If you need immediate updates, use the live widget instead.
Combining with Other Badges
The SVG badge works great alongside other badges:



What’s Next?
- Use the live widget for richer features
- Install the WordPress plugin
- Build custom integrations