diff --git a/content/docs/command-reference/remote/modify.md b/content/docs/command-reference/remote/modify.md
index 5085e59cf2..74fdcc6e83 100644
--- a/content/docs/command-reference/remote/modify.md
+++ b/content/docs/command-reference/remote/modify.md
@@ -539,6 +539,14 @@ more information.
   $ dvc remote modify myremote gss_auth true
   ```
 
+- `allow_agent` - whether to use [SSH agents](https://www.ssh.com/ssh/agent)
+  (`true` by default). Setting this to `false` is useful when `ssh-agent` is
+  causing problems, such as a "No existing session" error:
+
+  ```dvc
+  $ dvc remote modify myremote allow_agent false
+  ```
+
 </details>
 
 <details>