diff --git a/doc/api/cli.md b/doc/api/cli.md
index 8c241e7202bdb8..51a33f505e1027 100644
--- a/doc/api/cli.md
+++ b/doc/api/cli.md
@@ -2706,6 +2706,9 @@ The following environment variables are set when running a script with `--run`:
 * `NODE_RUN_PACKAGE_JSON_PATH`: The path to the `package.json` that is being
   processed.
 
+Environment variables loaded from a file with [`--env-file`][] are not applied
+to the command executed by `--run`.
+
 ### `--secure-heap-min=n`
 
 <!-- YAML