DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-history - Show the history of an image

# [SYNOPSIS](#SYNOPSIS)

**docker history \[OPTIONS] IMAGE**

# [DESCRIPTION](#DESCRIPTION)

Alias for **docker image history**.

# [OPTIONS](#OPTIONS)

**--format**="" Format output using a custom template: 'table': Print output in table format with column headers (default) 'table TEMPLATE': Print output in table format using the given Go template 'json': Print in JSON format 'TEMPLATE': Print output using the given Go template. Refer to https://docs.docker.com/go/formatting/ for more information about formatting output with templates

**-H**, **--human**\[=true] Print sizes and dates in human readable format

**--no-trunc**\[=false] Don't truncate output

**--platform**="" Show history for the given platform. Formatted as "os\[/arch\[/variant]]" (e.g., "linux/amd64")

**-q**, **--quiet**\[=false] Only show image IDs

# [SEE ALSO](#SEE_ALSO)

[**docker(1)**](/man/enterprise-packages/docker-cli-fips/docker.1)

Oct 2026 Docker Community

---

Document: docker-history(1) from docker-cli-fips 29.9.1-r0 (Chainguard OS)
Source: https://github.com/docker/cli