GitLab
Badges for GitLab repositories — stars, forks, issues, pipeline status, releases, and more.
Display live stats from any public GitLab repository.
Stars (branded)
Release
Pipeline
License
Last activity
Forks (branded)
Available badges
| Category | Topics | Description |
|---|---|---|
| Stars | stars | Repository star count |
| Forks | forks | Repository fork count |
| Pipeline | pipeline | Latest CI/CD pipeline status |
| Issues | issues, open-issues, closed-issues | Issue counts by state |
| Release | release | Latest release tag |
| License | license | Repository license |
| Repository | contributors, last-commit | Other project metadata |
URL format
/gitlab/{owner}/{repo}/{topic}.svgQuick examples
Data source
Uses the GitLab API v4. No API key required for public projects. Cached 1 hour, pipeline cached 5 minutes.
Endpoint details
Use these sections when you need the exact URL shape or a focused example for a specific badge type.
GitLab Forks
This section covers the gitlab/forks badge endpoint.
Show how many times a GitLab project has been forked.
GET/gitlab/:owner/:repo/forks.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg?mode=light"></picture>
URL format
/gitlab/{owner}/{repo}/forks.svgCopy-paste examples
Default — show fork activity
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg?mode=dark"><img alt="forks" src="https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg?mode=light"></picture>Branded — GitLab orange
GitLab Issues
This section covers the gitlab/issues badge endpoint.
Show open or closed issue counts for a GitLab project.
GET/gitlab/:owner/:repo/issues.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg?mode=light"></picture>
URL formats
Open issues
/gitlab/{owner}/{repo}/issues.svg/gitlab/{owner}/{repo}/open-issues.svgClosed issues
/gitlab/{owner}/{repo}/closed-issues.svgCopy-paste examples
Default — open issue count
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg?mode=dark"><img alt="issues" src="https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg?mode=light"></picture>Branded — GitLab orange
GitLab License
This section covers the gitlab/license badge endpoint.
Show the detected license for a GitLab project.
GET/gitlab/:owner/:repo/license.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?mode=light"></picture>
URL format
/gitlab/{owner}/{repo}/license.svgCopy-paste examples
Default — detected license name
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?mode=dark"><img alt="license" src="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?mode=light"></picture>Outline — subtle license indicator
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?variant=outline&mode=dark"><img alt="license" src="https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?variant=outline&mode=light"></picture>GitLab Pipeline
This section covers the gitlab/pipeline badge endpoint.
Show the status of the most recent GitLab CI/CD pipeline.
GET/gitlab/:owner/:repo/pipeline.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?mode=light"></picture>
URL format
/gitlab/{owner}/{repo}/pipeline.svg/gitlab/{owner}/{repo}/pipeline.svg?branch=mainStatus values
| Status | Color | Description |
|---|---|---|
passing | Green | Pipeline succeeded |
failing | Red | Pipeline failed |
running | Amber | Pipeline is running |
pending | Amber | Pipeline is pending |
canceled | Gray | Pipeline was canceled |
skipped | Gray | Pipeline was skipped |
Copy-paste examples
Default — shows latest pipeline status
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?mode=dark"><img alt="pipeline" src="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?mode=light"></picture>Secondary — softer CI badge
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?variant=secondary&mode=dark"><img alt="pipeline" src="https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?variant=secondary&mode=light"></picture>GitLab Release
This section covers the gitlab/release badge endpoint.
Show the latest release tag from GitLab Releases.
GET/gitlab/:owner/:repo/release.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg?mode=light"></picture>
URL format
/gitlab/{owner}/{repo}/release.svgCopy-paste examples
Default — latest release tag
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg?mode=dark"><img alt="release" src="https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg?mode=light"></picture>Branded — GitLab orange
GitLab Repository
This section covers the gitlab/repository badge endpoint.
Show contributor count and last activity for a GitLab project.
Contributors (branded)
Last activity
Contributors (outline)
Last activity (default)
URL formats
Contributors
/gitlab/{owner}/{repo}/contributors.svgLast activity
/gitlab/{owner}/{repo}/last-commit.svgCopy-paste examples
Default — contributor count
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/contributors.svg?mode=dark"><img alt="contributors" src="https://shieldcn.dev/gitlab/inkscape/inkscape/contributors.svg?mode=light"></picture>Secondary — how recently the project was active
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/last-commit.svg?variant=secondary&mode=dark"><img alt="last activity" src="https://shieldcn.dev/gitlab/inkscape/inkscape/last-commit.svg?variant=secondary&mode=light"></picture>GitLab Stars
This section covers the gitlab/stars badge endpoint.
Show how many stars a GitLab project has earned.
GET/gitlab/:owner/:repo/stars.svg
Path Parameters
required
required
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg?mode=dark"><img alt="badge" src="https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg?mode=light"></picture>
URL format
/gitlab/{owner}/{repo}/stars.svgCopy-paste examples
Default — works great in any README
<picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg?mode=dark"><img alt="stars" src="https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg?mode=light"></picture>Branded — GitLab's brand color
