PyPI Shields/Pins

PyPI Shields/Pins are shields for your GitHub repo, documentation or website that show how many times your project has been downloaded, its latest version, whether you provide egg and wheel distributions and what license your project is released under.

Service Status

Service status is provided by the wonderful guys at

Shield Styling

You can change the style of the shield from the rounded corners to a cleaner, flat style by setting a style value in the REQUEST_URI.

If no style is provided, the default rounded corner style will be used, setting the style value to ‘flat’ will use the flat style as seen below.


Original vs flat comparison

Original Flat

Using other image formats

By default, returns images in SVG format but you can have it return other formats by changing the badge extension.

As an example you could use any of the following extensions;

  • SVG
  • PNG
  • JPEG
  • GIF
  • TIFF


Written and maintained by Kura.


PyPI Pin uses;

Indices and tables