This is the home of Shields.io, home to the badge design specification, API documentation, and server code for Badges as a Service.
We invite participation through GitHub Issues, which we use much like a discussion forum. This repository should only contain non-implementation specific topics: specifications, design, and the web site.
Note that the root gets redirected to http://shields.io.
For testing purposes, you can go to
- The left-hand side of a badge should not advertize. It should be a noun describing succinctly the meaning of the right-hand-side data.
- New query parameters (such as
?style=) should apply to any requested badge. They must be registered in the cache (see
- The format of new badges should be of the form
/VENDOR/SUBVENDOR-BADGE-SPECIFIC/PARAMETERS.format. For instance,
https://img.shields.io/gitter/room/nwjs/nw.js.svg. The vendor is gitter, the badge is for rooms, the parameter is nwjs/nw.js, and the format is svg.
The main implementation, available at http://shields.io, has its code located in this repository.
Other systems that produce badges following the same design, hosted elsewhere, are listed below.
|website / AP||language||issues|
|old img.shields.io (discontinued)||Python||img.shields.io-old|
Please report bugs and discuss implementation specific concerns (performance characteristics, etc.) in the repository for the respective implementation.
Adding support for a service
Please open an issue if you'd like to use Shields badges for a project that isn't yet supported.