Pixel-perfect   Retina-ready   Fast   Consistent   Hackable   No tracking


Downloads

Mozilla Add-on:/amo/dw/:addonId.svg
Mozilla Add-on:/amo/users/:addonId.svg
Ansible Role:/ansible/role/d/:roleId.svg
APM:/apm/dm/:packageName.svg
Chocolatey:/chocolatey/dt/:packageName.svg
Chrome Web Store:/chrome-web-store/users/:storeId.svg
ClojarsDownloads:/clojars/dt/:clojar+.svg
Conda:/conda/dn/:channel/:package.svg
Crates.io:/crates/:variant/:crate.svg
Crates.io:/crates/:variant/:crate/:version.svg
Docker Pulls:/docker/pulls/:user/:repo.svg
DUB:/dub/:interval/:packageName/:version*.svg
DUB (version):/dub/:interval/:packageName/:version*.svg
DUB (latest):/dub/:interval/:packageName/:version*.svg
Eclipse Marketplace:/eclipse-marketplace/dm/:name.svg
Eclipse Marketplace:/eclipse-marketplace/dt/:name.svg
Gem:/gem/dv/:gem/:version.svg
Gem:/gem/dv/:gem/:version.svg
Gem:/gem/dtv/:gem.svg
Gem:/gem/dt/:gem.svg
Gem download rank:/gem/rt/:gem.svg
Gem download rank (daily):/gem/rd/:gem.svg
GitHub All Releases:/github/downloads/:user/:repo/total.svg
GitHub Releases:/github/downloads/:user/:repo/:tag/total.svg
GitHub Pre-Releases:/github/downloads-pre/:user/:repo/:tag/total.svg
GitHub Releases (by Release):/github/downloads/:user/:repo/:tag/total.svg
GitHub Releases (by Asset):/github/downloads/:user/:repo/:tag/:path.svg
GitHub Pre-Releases (by Asset):/github/downloads-pre/:user/:repo/:tag/:path.svg
Hex.pm:/hexpm/dd/:packageName.svg
Hex.pm:/hexpm/dw/:packageName.svg
Hex.pm:/hexpm/dt/:packageName.svg
Jenkins Plugin installs:/jenkins/plugin/i/:plugin.svg
Jenkins Plugin installs (version):/jenkins/plugin/i/:plugin/:version.svg
JetBrains IntelliJ plugins:/jetbrains/plugin/d/:pluginId.svg
JitPack - Downloads:/jitpack/:interval/:vcs/:user/:repo.svg
jsDelivr hits (GitHub):/jsdelivr/gh/:period/:user/:repo.svg
jsDelivr hits (npm):/jsdelivr/npm/:period/:packageName.svg
jsDelivr hits (npm scoped):/jsdelivr/npm/:period/:scope?/:packageName.svg
MyGet:/myget/:feed/dt/:packageName.svg
MyGet tenant:/:tenant.myget/:feed/dt/:packageName.svg
npm:/npm/:interval/:scope?/:packageName.svg
Nuget:/nuget/dt/:packageName.svg
Package Control:/packagecontrol/dd/:packageName.svg
Package Control:/packagecontrol/dw/:packageName.svg
Package Control:/packagecontrol/dm/:packageName.svg
Package Control:/packagecontrol/dt/:packageName.svg
Packagist:/packagist/:interval/:user/:repo.svg
PowerShell Gallery:/powershellgallery/dt/:packageName.svg
Puppet Forge downloads:/puppetforge/dt/:user/:moduleName.svg
PyPI - Downloads:/pypi/:period/:packageName.svg
JetBrains ReSharper plugins:/resharper/dt/:packageName.svg
SourceForge:/sourceforge/:interval/:project.svg
SourceForge:/sourceforge/:interval/:project/:folder.svg
Spiget Downloads:/spiget/downloads/:resourceId.svg
Steam Downloads:/steam/downloads/:fileId.svg
Visual Studio Marketplace Installs - Azure DevOps Extension:/visual-studio-marketplace/azure-devops/installs/:measure/:extensionId.svg
Visual Studio Marketplace Installs:/visual-studio-marketplace/i/:extensionId.svg
Visual Studio Marketplace Downloads:/visual-studio-marketplace/d/:extensionId.svg
WordPress Plugin Downloads:/wordpress/plugin/dd/:slug.svg
WordPress Plugin Downloads:/wordpress/plugin/dw/:slug.svg
WordPress Plugin Downloads:/wordpress/plugin/dm/:slug.svg
WordPress Plugin Downloads:/wordpress/plugin/dy/:slug.svg
WordPress Plugin Downloads:/wordpress/plugin/dt/:slug.svg
WordPress Theme Downloads:/wordpress/theme/dt/:slug.svg
WordPress Plugin Active Installs:/wordpress/plugin/installs/:slug.svg
WordPress Theme Active Installs:/wordpress/theme/installs/: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

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?

Have an idea for an awesome new badge?
Tell us about it and we might bring it to you!

StatusMetricsGitHub