Pixel-perfect Retina-ready Fast Consistent Hackable No tracking
Platform & Version Support
| Cocoapods platforms: |  | /cocoapods/p/AFNetworking.svg |
|---|---|---|
| Conda: |  | /conda/pn/conda-forge/python.svg |
| GitHub package.json dependency version (prod): |  | /github/package-json/dependency-version/developit/microbundle/rollup.svg |
| GitHub package.json dependency version (dev dep on branch): |  | /github/package-json/dependency-version/zeit/next.js/dev/%40babel/preset-react/canary.svg |
| node: |  | /node/v/passport.svg |
| node (scoped): | | /node/v/@stdlib/stdlib.svg |
| node (tag): |  | /node/v/passport/latest.svg |
| node (scoped with tag): | | /node/v/@stdlib/stdlib/latest.svg |
| node (scoped with tag, custom registry): | | /node/v/@stdlib/stdlib/latest.svg?registry_uri=https%3A%2F%2Fregistry.npmjs.com |
| npm peer dependency version: |  | /npm/dependency-version/react-boxplot/peer/prop-types.svg |
| npm peer dependency version (scoped): |  | /npm/dependency-version/%40swellaby/eslint-config/dev/eslint.svg |
| npm dev dependency version: |  | /npm/dependency-version/react-boxplot/dev/eslint-config-standard.svg |
| npm dev dependency version (scoped): |  | /npm/dependency-version/mocha/dev/%40mocha/contributors.svg |
| npm (prod) dependency version: |  | /npm/dependency-version/react-boxplot/simple-statistics.svg |
| npm (prod) dependency version (scoped): |  | /npm/dependency-version/got/%40sindresorhus/is.svg |
| npm type definitions: |  | /npm/types/chalk.svg |
| PHP from Packagist: |  | /packagist/php-v/symfony/symfony.svg |
| PHP from Packagist (specify version): |  | /packagist/php-v/symfony/symfony/v2.8.0.svg |
| PowerShell Gallery: |  | /powershellgallery/p/Az.Storage.svg |
| Puppet Forge – PDK version: |  | /puppetforge/pdk-version/tragiccode/azure_key_vault.svg |
| PyPI - Django Version: |  | /pypi/djversions/djangorestframework.svg |
| PyPI - Implementation: |  | /pypi/implementation/Django.svg |
| PyPI - Python Version: |  | /pypi/pyversions/Django.svg |
| PyPI - Wheel: |  | /pypi/wheel/Django.svg |
| Spiget tested server versions: |  | /spiget/tested-versions/9089.svg |
| PHP from Travis config: | | /travis/php-v/symfony/symfony.svg |
| WordPress Plugin: Required WP Version: |  | /wordpress/plugin/wp-version/bbpress.svg |
| WordPress Plugin: Tested WP Version: |  | /wordpress/plugin/tested/bbpress.svg |
Your Badge
Static
Using dash "-" separator
/badge/<LABEL>-<MESSAGE>-<COLOR>.svg
Dashes -- | → | - Dash |
Underscores __ | → | _ Underscore |
_ or Space | → | Space |
Using query string parameters
/static/v1.svg?label=<LABEL>&message=<MESSAGE>&color=<COLOR>
Colors
Endpoint
/endpoint.svg?url=<URL>&style<STYLE>
Create badges from your own JSON endpoint.
Dynamic
/badge/dynamic/json.svg?url=<URL>&label=<LABEL>&query=<$.DATA.SUBDATA>&color=<COLOR>&prefix=<PREFIX>&suffix=<SUFFIX>
/badge/dynamic/xml.svg?url=<URL>&label=<LABEL>&query=<//data/subdata>&color=<COLOR>&prefix=<PREFIX>&suffix=<SUFFIX>
/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=appveyor |  |
?style=flat&logo=appveyor |  |
?style=flat-square&logo=appveyor |  |
?style=for-the-badge&logo=appveyor |  |
?style=popout&logo=appveyor |  |
?style=popout-square&logo=appveyor |  |
?style=social&logo=appveyor |  |
Here are a few other parameters you can use: (connecting several with "&" is possible)
?label=healthinesses | Override the default left-hand-side text (URL-Encoding needed for spaces or special characters!) |
?logo=appveyor | Insert 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=violet | Set the color of the logo (hex, rgb, rgba, hsl, hsla and css named colors supported) |
?logoWidth=40 | Set the horizontal space to give to the logo |
?link=http://left&link=http://right | Specify what clicking on the left/right of a badge should do (esp. for social badge style) |
?labelColor=abcdef | Set background of the left part (hex, rgb, rgba, hsl, hsla and css named colors supported). The legacy name "colorA" is also supported. |
?color=fedcba | Set background of the right part (hex, rgb, rgba, hsl, hsla and css named colors supported). The legacy name "colorB" is also supported. |
?cacheSeconds=3600 | Set 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!