diff --git a/docs/keyword-replacement.md b/docs/keyword-replacement.md
index eb7ee24e6..32f248cea 100644
--- a/docs/keyword-replacement.md
+++ b/docs/keyword-replacement.md
@@ -78,6 +78,11 @@ The keyword preservation functionality will attempt to preserve as many keywords
 
 To learn more about the history and technical challenges of of keyword preservation, refer to [RFC: Keyword Preservation During Export](https://github.com/auth0/auth0-deploy-cli/issues/688).
 
+## Environment Variables
+
+Environment variables are added into the keyword replacement mappings object automatically.
+This means that you can refer to environment variables by name in your config with the same `@@EXAMPLE_KEY@@` or `##EXAMPLE_KEY##` syntax.
+
 ---
 
 [[table of contents]](../README.md#documentation)