GitLab — shieldcn

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}.svg

Quick examples

![stars](https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg)

![pipeline](https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?variant=branded)

![release](https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg)

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

ownerrequired

reporequired

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg)

URL format

/gitlab/{owner}/{repo}/forks.svg

Copy-paste examples

Default — show fork activity

![forks](https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg)

Branded — GitLab orange

![forks](https://shieldcn.dev/gitlab/inkscape/inkscape/forks.svg?variant=branded)

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

ownerrequired

reporequired

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg)

URL formats

Open issues

/gitlab/{owner}/{repo}/issues.svg

/gitlab/{owner}/{repo}/open-issues.svg

Closed issues

/gitlab/{owner}/{repo}/closed-issues.svg

Copy-paste examples

Default — open issue count

![issues](https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg)

Branded — GitLab orange

![issues](https://shieldcn.dev/gitlab/inkscape/inkscape/issues.svg?variant=branded)

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

ownerrequired

reporequired

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg)

URL format

/gitlab/{owner}/{repo}/license.svg

Copy-paste examples

Default — detected license name

![license](https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg)

Outline — subtle license indicator

![license](https://shieldcn.dev/gitlab/inkscape/inkscape/license.svg?variant=outline)

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

ownerrequired

reporequired

branch

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg)

URL format

/gitlab/{owner}/{repo}/pipeline.svg

/gitlab/{owner}/{repo}/pipeline.svg?branch=main

Status 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

![pipeline](https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg)

Secondary — softer CI badge

![pipeline](https://shieldcn.dev/gitlab/inkscape/inkscape/pipeline.svg?variant=secondary)

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

ownerrequired

reporequired

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg)

URL format

/gitlab/{owner}/{repo}/release.svg

Copy-paste examples

Default — latest release tag

![release](https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg)

Branded — GitLab orange

![release](https://shieldcn.dev/gitlab/inkscape/inkscape/release.svg?variant=branded)

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.svg

Last activity

/gitlab/{owner}/{repo}/last-commit.svg

Copy-paste examples

Default — contributor count

![contributors](https://shieldcn.dev/gitlab/inkscape/inkscape/contributors.svg)

Secondary — how recently the project was active

![last activity](https://shieldcn.dev/gitlab/inkscape/inkscape/last-commit.svg?variant=secondary)

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

ownerrequired

reporequired

format

variant

size

theme

mode

logo

logoColor

label

flags

split

![badge](https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg)

URL format

/gitlab/{owner}/{repo}/stars.svg

Copy-paste examples

Default — works great in any README

![stars](https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg)

Branded — GitLab's brand color

![stars](https://shieldcn.dev/gitlab/inkscape/inkscape/stars.svg?variant=branded)