Docker Hub

Badges for Docker images — pulls, stars, version, image size.

Display live stats for any image on Docker Hub.

Available badges

BadgeEndpointDescription
Pulls/docker/pulls/{image}Total pull count
Stars/docker/stars/{image}Star count
Version/docker/v/{image}Latest tag
Image Size/docker/size/{image}Compressed image size

Quick examples

![pulls](https://shieldcn.dev/docker/pulls/library/nginx.svg)
![stars](https://shieldcn.dev/docker/stars/grafana/grafana.svg)
![size](https://shieldcn.dev/docker/size/library/alpine.svg)
GET/docker/pulls/:image.svg

Path Parameters

required

Use library/ prefix for official images.

![badge](https://shieldcn.dev/docker/pulls/library%2Fnginx.svg)
badge preview

Image naming

  • Official images: library/nginx, library/alpine, library/node
  • User images: grafana/grafana, portainer/portainer

Data source

Uses Docker Hub API v2. No API key required. Cached 1 hour.