Badge Embed Guide

Add real-time version health, EOL countdowns, and CVE badges to your README, docs, or website. Every badge auto-updates — zero maintenance.

Quick Start

1. Pick your product from the badge index (300+ supported)

2. Copy the snippet and swap in your product slug

3. Paste into your README — done

![Python Health](https://img.releaserun.com/badge/health/python.svg)
![Node.js 20 EOL](https://img.releaserun.com/badge/eol/nodejs/20.svg)

Badge Types

🟢

Health

Overall health grade (A–F) combining freshness, EOL status, and security data into one score.

/badge/health/{product}.svg

/badge/health/{product}/{version}.svg

Target a specific version:

⏰

EOL Countdown

Days remaining until a version reaches end-of-life, or flags it as already EOL. Pin this next to your minimum supported version.

/badge/eol/{product}/{version}.svg

🔄

Freshness

Shows whether a version is up to date, slightly behind, outdated, or critically outdated relative to the latest release.

/badge/v/{product}/{version}.svg

🛡️

CVE

Known CVE count by severity. Currently available for Kubernetes — more products coming soon.

/badge/cve/{product}/{version}.svg

☁️

Cloud Provider

Shows K8s version support on EKS, GKE, or AKS with patch details.

/badge/cloud/{provider}/{version}.svg

Embed Snippets

Markdown

GitHub, GitLab, npm

[![Python](https://img.releaserun.com/badge/health/python.svg)](https://releaserun.com/badges/python/)

HTML

Websites, documentation

<a href="https://releaserun.com/badges/python/">
  <img src="https://img.releaserun.com/badge/health/python.svg"
       alt="Python Health">
</a>

reStructuredText

Sphinx, ReadTheDocs

.. image:: https://img.releaserun.com/badge/health/python.svg
   :target: https://releaserun.com/badges/python/
   :alt: Python Health

Customisation

All badges accept these query parameters:

style

flat · flat-square · plastic · for-the-badge

label

Override the left-side text

labelColor

Hex colour for the label background

Flat

Flat Square

For the Badge

Plastic

Real-World Examples

Node.js Project

[![Node.js](https://img.releaserun.com/badge/health/nodejs.svg)](https://releaserun.com/badges/nodejs/)
[![Node 20 EOL](https://img.releaserun.com/badge/eol/nodejs/20.svg)](https://releaserun.com/badges/nodejs/)
[![Node 22 EOL](https://img.releaserun.com/badge/eol/nodejs/22.svg)](https://releaserun.com/badges/nodejs/)

Kubernetes Project

[![K8s](https://img.releaserun.com/badge/health/kubernetes.svg)](https://releaserun.com/badges/kubernetes/)
[![CVEs](https://img.releaserun.com/badge/cve/kubernetes/1.31.svg)](https://releaserun.com/badges/kubernetes/)
[![EKS](https://img.releaserun.com/badge/cloud/eks/1.31.svg)](https://releaserun.com/badges/kubernetes/)

300+ Products

Works with anything on endoflife.date — Python, Node.js, Go, Rust, Ruby, PHP, Java, .NET, Docker, Kubernetes, PostgreSQL, MySQL, Redis, Terraform, and hundreds more. Just use the product slug in the URL.

Browse all products →

ReleaseRun vs Shields.io

Use them together. Shields.io handles CI status and coverage. We handle what they can't:

✅ Version health grades (A–F)
✅ EOL countdowns with days remaining
✅ CVE severity counts per version
✅ Cloud provider K8s compatibility
✅ Version freshness scoring

Badges are real-time SVGs. Data from endoflife.date (300+ products) plus ReleaseRun's CVE and cloud databases. Cached 5 min with stale-while-revalidate — your README will never show a broken image.