docs/engine/admin/formatting.md

description	keywords	title
CLI and log output formatting reference	format, formatting, output, templates, log	Format command and log output

Docker uses Go templates to allow users manipulate the output format of certain commands and log drivers. Each command a driver provides a detailed list of elements they support in their templates:

• Docker Images formatting
• Docker Inspect formatting
• Docker Log Tag formatting
• Docker Network Inspect formatting
• Docker PS formatting
• Docker Stats formatting
• Docker Volume Inspect formatting
• Docker Version formatting

Template functions

Docker provides a set of basic functions to manipulate template elements. This is the complete list of the available functions with examples:

join

join concatenates a list of strings to create a single string. It puts a separator between each element in the list.

{% raw %}
$ docker ps --format '{{join .Names " or "}}'
{% endraw %}

json

json encodes an element as a json string.

{% raw %}
$ docker inspect --format '{{json .Mounts}}' container
{% endraw %}

lower

lower transforms a string into its lowercase representation.

{% raw %}
$ docker inspect --format "{{lower .Name}}" container
{% endraw %}

split

split slices a string into a list of strings separated by a separator.

{% raw %}
$ docker inspect --format '{{split (join .Names "/") "/"}}' container

{% endraw %}

title

title capitalizes the first character of a string.

{% raw %}
$ docker inspect --format "{{title .Name}}" container
{% endraw %}

upper

upper transforms a string into its uppercase representation.

{% raw %}
$ docker inspect --format "{{upper .Name}}" container
{% endraw %}