diff --git a/app/vmauth/README.md b/app/vmauth/README.md
index e0128ae43..6ccc09d9f 100644
--- a/app/vmauth/README.md
+++ b/app/vmauth/README.md
@@ -36,7 +36,8 @@ Each `url_prefix` in the [-auth.config](#auth-config) may contain either a singl
 
 ```yml
 # Arbitrary number of usernames may be put here.
-# Username and bearer_token values must be unique.
+# It is possible to set multiple identical usernames with different passwords.
+# Such usernames can be differentiated by `name` option.
 
 users:
   # Requests with the 'Authorization: Bearer XXXX' and 'Authorization: Token XXXX'
diff --git a/app/vmauth/example_config.yml b/app/vmauth/example_config.yml
index f77c07067..a505c4854 100644
--- a/app/vmauth/example_config.yml
+++ b/app/vmauth/example_config.yml
@@ -1,5 +1,6 @@
 # Arbitrary number of usernames may be put here.
-# Username and bearer_token values must be unique.
+# It is possible to set multiple identical usernames with different passwords.
+# Such usernames can be differentiated by `name` option.
 
 users:
   # Requests with the 'Authorization: Bearer XXXX' and 'Authorization: Token XXXX'
diff --git a/docs/vmauth.md b/docs/vmauth.md
index 86bf68b69..fb4121924 100644
--- a/docs/vmauth.md
+++ b/docs/vmauth.md
@@ -40,7 +40,8 @@ Each `url_prefix` in the [-auth.config](#auth-config) may contain either a singl
 
 ```yml
 # Arbitrary number of usernames may be put here.
-# Username and bearer_token values must be unique.
+# It is possible to set multiple identical usernames with different passwords.
+# Such usernames can be differentiated by `name` option.
 
 users:
   # Requests with the 'Authorization: Bearer XXXX' and 'Authorization: Token XXXX'