diff --git a/data/cli/engine/docker_login.yaml b/data/cli/engine/docker_login.yaml
index d8d0c93eb7..96f9545b23 100644
--- a/data/cli/engine/docker_login.yaml
+++ b/data/cli/engine/docker_login.yaml
@@ -158,7 +158,7 @@ options:
     - option: password
       shorthand: p
       value_type: string
-      description: Password or Personal Access Token (PAT)
+      description: Password or Personal Access Token (PAT), or `-` to read from stdin
       deprecated: false
       hidden: false
       experimental: false
@@ -272,6 +272,13 @@ examples: |-
     ```console
     $ cat ~/my_password.txt | docker login --username foo --password-stdin
     ```
+
+    You can also pass `-` as the value for `--password` or `-p` to read the
+    password from `STDIN`.
+
+    ```console
+    $ cat ~/my_password.txt | docker login --username foo --password -
+    ```
 deprecated: false
 hidden: false
 experimental: false