Static Badge

Create a badge with any custom text and color.

GET/badge/:badgeContent.svg

Path Parameters

required

Dashes separate label, message, and color. Underscores → spaces.

![badge](https://shieldcn.dev/badge/build-passing-green.png)
badge preview

Text encoding

InputOutput
_ or %20Space
__Literal _
--Literal -

Named colors

brightgreen, green, yellow, orange, red, blue, purple, violet, grey, lightgrey — or any hex value.

Examples

build passing
Named color (green)
version
Secondary variant
license
Outline variant
PRs welcome
Community badge
beta
Status badge
coverage
Blue theme

Copy-paste examples

Classic build badge for status rows

![build passing](https://shieldcn.dev/badge/build-passing-green.svg)

Outline — subtle metadata badge for repo headers

![license MIT](https://shieldcn.dev/badge/license-MIT-green.svg?variant=outline)

Secondary — contributor-friendly signal

![PRs welcome](https://shieldcn.dev/badge/PRs-welcome-brightgreen.svg?variant=secondary)