Shields.io

Pixel-perfect   Retina-ready   Fast   Consistent   Hackable   No tracking


Build

Chat

Dependencies

Size

Downloads

Funding

Issue Tracking

License

Rating

Social

Version

Platform & Version Support

Monitoring

Activity

Other

Your Badge

Static


https://img.shields.io/badge/<SUBJECT>-<STATUS>-<COLOR>.svg

Dashes --- Dash
Underscores ___ Underscore
_ or Space    Space

brightgreen green yellowgreen yellow orange red lightgrey blue ff69b4

Dynamic

https://img.shields.io/badge/dynamic/json.svg?url=<URL>&label=<LABEL>&query=<$.DATA.SUBDATA>&colorB=<COLOR>&prefix=<PREFIX>&suffix=<SUFFIX>

https://img.shields.io/badge/dynamic/xml.svg?url=<URL>&label=<LABEL>&query=<//data/subdata>&colorB=<COLOR>&prefix=<PREFIX>&suffix=<SUFFIX>

https://img.shields.io/badge/dynamic/yaml.svg?url=<URL>&label=<LABEL>&query=<$.DATA.SUBDATA>&colorB=<COLOR>&prefix=<PREFIX>&suffix=<SUFFIX>


Styles

The following styles are available. Flat is the default. Examples are shown with an optional logo:

plastichttps://img.shields.io/badge/style-plastic-green.svg?logo=appveyor&style=plastic
flathttps://img.shields.io/badge/style-flat-green.svg?logo=appveyor&style=flat
flat-squarehttps://img.shields.io/badge/style-flat--square-green.svg?logo=appveyor&style=flat-square
for-the-badgehttps://img.shields.io/badge/style-for--the--badge-green.svg?logo=appveyor&style=for-the-badge
popouthttps://img.shields.io/badge/style-popout-green.svg?logo=appveyor&style=popout
popout-squarehttps://img.shields.io/badge/style-popout--square-green.svg?logo=appveyor&style=popout-square
socialhttps://img.shields.io/badge/style-social-green.svg?logo=appveyor&style=social

Here are a few other parameters you can use: (connecting several with "&" is possible)

?label=healthinessesOverride the default left-hand-side text (URL-Encoding needed for spaces or special characters!)
?logo=appveyorInsert one of the named logos from (appveyor, bitcoin, bithound, circleci, codeship, dependabot, discord, docker, eclipse, github, gitlab, gitter-white, gratipay, lgtm, liberapay, matrix, npm, paypal, postgresql, scrutinizer, serverfault, slack, sourcegraph, stackexchange, stackoverflow, superuser, telegram, tfs, travis, twitter, windows) or simple-icons
?logo=data:image/png;base64,…Insert custom logo image (≥ 14px high)
?logoColor=violetSet the color of the logo (hex, rgb, rgba, hsl, hsla and css named colors supported)
?logoWidth=40Set the horizontal space to give to the logo
?link=http://left&link=http://rightSpecify what clicking on the left/right of a badge should do (esp. for social badge style)
?colorA=abcdefSet background of the left part (hex, rgb, rgba, hsl, hsla and css named colors supported)
?colorB=fedcbaSet background of the right part (hex, rgb, rgba, hsl, hsla and css named colors supported)
?maxAge=3600Set the HTTP cache lifetime in secs (rules are applied to infer a default value on a per-badge basis, any values specified below the default will be ignored)

We support .svg, .json, .png and a few others, but use them responsibly.

Like This?

What is your favorite badge service to use?
Tell us and we might bring it to you!

StatusGitHub