GitHub

Badges for GitHub repositories — stars, forks, releases, CI, issues, PRs, and more.

All GitHub badges support both URL formats:

  • /github/{topic}/{owner}/{repo}.svg
  • /github/{owner}/{repo}/{topic}.svg
GET/github/:topic/:owner/:repo.svg

Path Parameters

required

See all topics below.

required
required
![badge](https://shieldcn.dev/github/stars/vercel/next.js.svg)
badge preview

Repository

TopicLabelExample
starsstars/github/stars/vercel/next.js
forksforks/github/forks/vercel/next.js
watcherswatchers/github/watchers/vercel/next.js
licenselicense/github/license/vercel/next.js
branchesbranches/github/branches/vercel/next.js
contributorscontributors/github/contributors/vercel/next.js
dependabotdependabot/github/dependabot/ubuntu/yaru

Releases & Tags

TopicLabelExample
releaselatest release tag/github/release/babel/babel
release/{owner}/{repo}/stablelatest stable (non-prerelease)/github/release/babel/babel/stable
releasesrelease count/github/releases/micromatch/micromatch
tagstag count/github/tags/micromatch/micromatch
taglatest tag name/github/tag/micromatch/micromatch
assets-dlasset downloads (latest)/github/assets-dl/electron/electron
assets-dl/{owner}/{repo}/{tag}asset downloads (specific tag)/github/assets-dl/electron/electron/v7.0.0

CI & Checks

TopicLabelExample
ciGitHub Actions status/github/ci/jal-co/ui
ci + ?workflow=ci.ymlspecific workflow/github/ci/jal-co/ui?workflow=ci.yml
ci + ?branch=mainspecific branch/github/ci/jal-co/ui?branch=main
checks/{owner}/{repo}combined check conclusion/github/checks/nodejs/node
checks/{owner}/{repo}/{ref}checks for a branch/tag/github/checks/nodejs/node/canary-base
checks/{owner}/{repo}/{ref}/{name}single check by job name/github/checks/nodejs/node/main/lint-cpp

CI and checks badges show a colored status dot and colored value text by default. Use ?split=true for a two-tone background instead.

Issues

TopicLabelExample
issuesopen issues/github/issues/micromatch/micromatch
open-issuesopen issues/github/open-issues/micromatch/micromatch
closed-issuesclosed issues/github/closed-issues/micromatch/micromatch
label-issues/{owner}/{repo}/{label}issues by label/github/label-issues/nodejs/node/ES%20Modules
label-issues/{owner}/{repo}/{label}/openopen issues by label/github/label-issues/atom/atom/help-wanted/open
label-issues/{owner}/{repo}/{label}/closedclosed issues by label/github/label-issues/rust-lang/rust/B-RFC-approved/closed

Pull Requests

TopicLabelExample
prsopen PRs/github/prs/micromatch/micromatch
open-prsopen PRs/github/open-prs/micromatch/micromatch
closed-prsclosed PRs/github/closed-prs/micromatch/micromatch
merged-prsmerged PRs/github/merged-prs/micromatch/micromatch

Commits

TopicLabelExample
commitscommit count/github/commits/micromatch/micromatch
commits/{owner}/{repo}/{ref}commits on branch/tag/github/commits/micromatch/micromatch/gh-pages
last-commitlast commit time/github/last-commit/micromatch/micromatch
last-commit/{owner}/{repo}/{ref}last commit on branch/github/last-commit/micromatch/micromatch/gh-pages

Milestones

TopicLabelExample
milestones/{owner}/{repo}/{number}milestone completion %/github/milestones/chrislgarry/Apollo-11/1

Data source

All data from the GitHub REST API. Uses the token pool for distributed rate limiting. Most badges cached 1 hour, CI/checks cached 10 minutes.