docker-docs/engine/admin/formatting.md

description, keywords, menu, title

description	keywords	menu	title
CLI and log output formatting reference	format, formatting, output, templates, log	main parent weight engine_admin 7	Format command and log output

Formatting reference

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 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 turns a string into its lower case 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 a string.

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

Upper

Upper turns a string into its upper case representation.

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