Pixel-perfect   Retina-ready   Fast   Consistent   Hackable   No tracking


Platform & Version Support

Cocoapods platforms:https://img.shields.io/cocoapods/p/:spec.svg
Conda:https://img.shields.io/conda/pn/:channel/:package.svg
GitHub package.json dependency version (prod):https://img.shields.io/github/package-json/dependency-version/:user/:repo/:packageName.svg
GitHub package.json dependency version (dev dep on branch):https://img.shields.io/github/package-json/dependency-version/:user/:repo/dev/:scope?/:packageName/:branch*.svg
node:https://img.shields.io/node/v/:packageName.svg
node (scoped):https://img.shields.io/node/v/@:scope/:packageName.svg
node (tag):https://img.shields.io/node/v/:packageName/:tag.svg
node (scoped with tag):https://img.shields.io/node/v/@:scope/:packageName/:tag.svg
node (scoped with tag, custom registry):https://img.shields.io/node/v/@:scope/:packageName/:tag.svg?registry_uri=https%3A%2F%2Fregistry.npmjs.com
npm peer dependency version:https://img.shields.io/npm/dependency-version/:packageName/peer/:dependency.svg
npm dev dependency version:https://img.shields.io/npm/dependency-version/:packageName/dev/:dependency.svg
npm (prod) dependency version:https://img.shields.io/npm/dependency-version/:packageName/:dependency.svg
npm type definitions:https://img.shields.io/npm/types/:packageName.svg
PHP from Packagist:https://img.shields.io/packagist/php-v/:user/:repo.svg
HHVM:https://img.shields.io/hhvm/:user/:packageName.svg
HHVM (branch):https://img.shields.io/hhvm/:user/:packageName/:branch.svg
PHP version from PHP-Eye:https://img.shields.io/php-eye/:user/:repo.svg
PowerShell Gallery:https://img.shields.io/powershellgallery/p/:packageName.svg
Puppet Forge – PDK version:https://img.shields.io/puppetforge/pdk-version/:user/:moduleName.svg
PyPI - Django Version:https://img.shields.io/pypi/djversions/:packageName.svg
PyPI - Implementation:https://img.shields.io/pypi/implementation/:packageName.svg
PyPI - Python Version:https://img.shields.io/pypi/pyversions/:packageName.svg
PyPI - Wheel:https://img.shields.io/pypi/wheel/:packageName.svg
Spiget tested server versions:https://img.shields.io/spiget/tested-versions/:resourceId.svg
PHP from Travis config:https://img.shields.io/travis/php-v/:user/:repo.svg
Wordpress Plugin: Required WP Version:https://img.shields.io/wordpress/plugin/wp-version/:slug.svg
Wordpress Plugin: Tested WP Version:https://img.shields.io/wordpress/plugin/tested/:slug.svg

Your Badge

Static


Using dash "-" separator

https://img.shields.io/badge/<LABEL>-<MESSAGE>-<COLOR>.svg

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

Using query string parameters

https://img.shields.io/static/v1.svg?label=<LABEL>&message=<MESSAGE>&color=<COLOR>

Colors

brightgreengreenyellowgreenyelloworangeredbluelightgrey
successimportantcriticalinformationalinactive
bluevioletff69b49cf

Endpoint (Beta)

https://img.shields.io/endpoint.svg?url=<URL>&style<STYLE>

Create badges from your own JSON endpoint.

Dynamic

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

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

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


Styles

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

?style=plastic&logo=appveyorplastic
?style=flat&logo=appveyorflat
?style=flat-square&logo=appveyorflat-square
?style=for-the-badge&logo=appveyorfor-the-badge
?style=popout&logo=appveyorpopout
?style=popout-square&logo=appveyorpopout-square
?style=social&logo=appveyorsocial

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 (bitcoin, dependabot, discord, gitlab, npm, paypal, serverfault, stackexchange, superuser, telegram, travis) or simple-icons. Simple-icons are referenced using names as they appear on the simple-icons site. If the name includes spaces, replace them with dashes (e.g: ?logo=visual-studio-code)
?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)
?labelColor=abcdefSet background of the left part (hex, rgb, rgba, hsl, hsla and css named colors supported). The legacy name "colorA" is also supported.
?color=fedcbaSet background of the right part (hex, rgb, rgba, hsl, hsla and css named colors supported). The legacy name "colorB" is also supported.
?cacheSeconds=3600Set the HTTP cache lifetime (rules are applied to infer a default value on a per-badge basis, any values specified below the default will be ignored). The legacy name "maxAge" is also supported.

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