diff --git a/compose/compose-file/compose-file-v3.md b/compose/compose-file/compose-file-v3.md
index c5b8d885b6..411ee4bb9f 100644
--- a/compose/compose-file/compose-file-v3.md
+++ b/compose/compose-file/compose-file-v3.md
@@ -1641,6 +1641,10 @@ Expose ports.
 >
 > Port mapping is incompatible with `network_mode: host`
 
+> **Note**
+>
+> `docker-compose run` ignores `ports` unless you include `--service-ports`.
+
 #### Short syntax
 
 There are three options: