How to Add a Docker Pulls Badge

The shields.io docker/pulls route reads Docker Hub pull counts for a public image with no authentication.

Use docker/pulls/<owner>/<image> to render the total pull count for a Docker Hub repository. Pair it with an image size badge from the same family if you like.

Steps

Pulls: img.shields.io/docker/pulls/<owner>/<image>.
Image size: img.shields.io/docker/image-size/<owner>/<image>.
Link the badge to the Docker Hub page.

README markdown

README.md

[![Docker Pulls](https://img.shields.io/docker/pulls/acme/widget)](https://hub.docker.com/r/acme/widget)

Push step that grows the pulls source

.github/workflows/release.yml

      - uses: docker/build-push-action@v6
        with:
          push: true
          tags: acme/widget:latest

Gotchas

The route only works for Docker Hub; other registries (GHCR, ECR) do not expose a public pulls count.
Official library images use the library owner segment, for example docker/pulls/library/nginx.

Related guides

How to Add npm Version and Downloads BadgesAdd npm version and downloads badges with the shields.io npm/v and npm/dm routes, so the README reflects the… How to Add a Latest Release or Tag BadgeAdd a badge that always shows your latest GitHub release or tag using the shields.io github/v/release and git… How to Add a shields.io Build Status BadgeAdd a shields.io build status badge that reads GitHub Actions results through img.shields.io, giving you a st…