diff --git a/README.md b/README.md
index 85976349076c0a65a20b1100c475fb609588ae78..134ac72a70dfd8f9f2ede0fa1738cad504698535 100644
--- a/README.md
+++ b/README.md
@@ -34,12 +34,12 @@ external_url: 'https://localhost'
 # external url for gitlab pages, set to Null to disable
 pages_external_url: ~
 
-# alternative storage path for registry, set to Null to disable
-registry_path: ~
-
 # external url for the container registry, set to Null to disable
 registry_external_url: ~
 
+# alternative storage path for registry, only considere when registry_external_url is set. set to Null to use defaults
+registry_path: ~
+
 # external ssh host, can be different from external_url
 gitlab_ssh_host: 'localhost'