diff --git a/docs/usage/private-modules.md b/docs/usage/private-modules.md
index 1a666a54e17f63c672e68f24ffc99370cf76a37e..44d95db472515c7aabfc0aa99e8865b6f9cd5d12 100644
--- a/docs/usage/private-modules.md
+++ b/docs/usage/private-modules.md
@@ -51,7 +51,7 @@ module.exports = {
     {
       hostType: 'npm',
       hostName: 'registry.npmjs.org',
-      token: process.env.NPM_TOKEN,
+      token: process.env.NPMJS_TOKEN,
     },
     {
       hostType: 'npm',
@@ -64,6 +64,8 @@ module.exports = {
 };
 ```
 
+**NOTE:** Do not use `NPM_TOKEN` as an environment variable, it's incompatible with `hostRules` and will be deprecated soon.
+
 ### Commit .npmrc file into repository
 
 One approach that many projects use for private repositories is to simply check in an authenticated `.npmrc` into the repository that is then shared between all developers.