diff --git a/docs/configuration.md b/docs/configuration.md
index 719f7f10d95..af537772277 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -356,6 +356,10 @@ Applies on virtualenv creation.
 
 Directory where virtual environments will be created.
 
+{{% note %}}
+This setting controls the global virtual environment storage path. It most likely will not be useful at the local level. To store virtual environments in the project root, see `virtualenvs.in-project`.
+{{% /note %}}
+
 ### `virtualenvs.prefer-active-python` (experimental)
 
 **Type**: `boolean`