DOCKER(1) Docker User Manuals DOCKER(1)
NAME
docker-image-history - Show the history of an image
SYNOPSIS
docker image history [OPTIONS] IMAGE
DESCRIPTION
Show the history of when and how an image was created.
EXAMPLES
$ docker history fedora
IMAGE CREATED CREATED BY SIZE COMMENT
105182bb5e8b 5 days ago /bin/sh -c #(nop) ADD file:71356d2ad59aa3119d 372.7 MB
73bd853d2ea5 13 days ago /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar 0 B
511136ea3c5a 10 months ago 0 B Imported from -
Display comments in the image history
The docker commit command has a -m flag for adding comments to the im-
age. These comments will be displayed in the image history.
$ sudo docker history docker:scm
IMAGE CREATED CREATED BY SIZE COMMENT
2ac9d1098bf1 3 months ago /bin/bash 241.4 MB Added Apache to Fedora base image
88b42ffd1f7c 5 months ago /bin/sh -c #(nop) ADD file:1fd8d7f9f6557cafc7 373.7 MB
c69cab00d6ef 5 months ago /bin/sh -c #(nop) MAINTAINER Lokesh Mandvekar 0 B
511136ea3c5a 19 months ago 0 B Imported from -
Format the output
The formatting option (--format) will pretty-prints history output us-
ing a Go template.
Valid placeholders for the Go template are listed below:
┌──────────────┬────────────────────────────┐
│Placeholder │ Description │
├──────────────┼────────────────────────────┤
│.ID │ Image ID │
├──────────────┼────────────────────────────┤
│.CreatedSince │ Elapsed time since the im- │
│ │ age was created if --hu- │
│ │ man=true, otherwise time- │
│ │ stamp of when image was │
│ │ created │
├──────────────┼────────────────────────────┤
│.CreatedAt │ Timestamp of when image │
│ │ was created │
├──────────────┼────────────────────────────┤
│.CreatedBy │ Command that was used to │
│ │ create the image │
├──────────────┼────────────────────────────┤
│.Size │ Image disk size │
├──────────────┼────────────────────────────┤
│.Comment │ Comment for image │
└──────────────┴────────────────────────────┘
When using the --format option, the history command will either output
the data exactly as the template declares or, when using the table di-
rective, will include column headers as well.
The following example uses a template without headers and outputs the
ID and CreatedSince entries separated by a colon for all images:
$ docker images --format "{{.ID}}: {{.CreatedSince}} ago"
cc1b61406712: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 2 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
<missing>: 3 weeks ago
OPTIONS
--format="" Format output using a custom template: 'ta-
ble': Print output in table format with column headers (de-
fault) '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 for-
matting output with templates
-H, --human[=true] Print sizes and dates in human read-
able format
--no-trunc[=false] Don't truncate output
--platform="" Show history for the given platform. For-
matted as "os[/arch[/variant]]" (e.g., "linux/amd64")
-q, --quiet[=false] Only show image IDs
SEE ALSO
docker-image(1)
Docker Community Apr 2026 DOCKER(1)
Generated by dwww version 1.14 on Sat Jun 13 09:44:24 CEST 2026.