diff --git a/docs/reference/run.md b/docs/reference/run.md
index c3628e45cc..e9a671c279 100644
--- a/docs/reference/run.md
+++ b/docs/reference/run.md
@@ -1772,6 +1772,7 @@ the `USER` instruction by passing the `-u` option.
     --user=[ user | user:group | uid | uid:gid | user:gid | uid:group ]
 
 > **Note:** if you pass a numeric uid, it must be in the range of 0-2147483647.
+> If you pass a username, the user must exist in the container.
 
 ### WORKDIR