diff --git a/src/content/docs/en/guides/environment-variables.mdx b/src/content/docs/en/guides/environment-variables.mdx
index 1b8c4f73848c7..6d81276f47478 100644
--- a/src/content/docs/en/guides/environment-variables.mdx
+++ b/src/content/docs/en/guides/environment-variables.mdx
@@ -285,6 +285,10 @@ There are three kinds of environment variables, determined by the combination of
 **Secret client variables** are not supported because there is no safe way to send this data to the client. Therefore, it is not possible to configure both `context: "client"` and `access: "secret"` in your schema.
 :::
 
+:::note
+When using `output: 'server'`, `process.env` variables are bundled (hardcoded) into the server bundle during the `npm run build` phase. This means environment variables become part of the compiled server code rather than being read from the environment at runtime. You will need to rebuild to have fresh `.env` values.
+:::
+
 ### Data types
 
 There are currently four data types supported: strings, numbers, enums, and booleans: