diff --git a/docs/usage/configuration-options.md b/docs/usage/configuration-options.md
index 7a6c37a4aa3b7a5ab9b1f9381433d5705c25bb66..2d48d244e520c07d7904dd388e9c174273c7c29a 100644
--- a/docs/usage/configuration-options.md
+++ b/docs/usage/configuration-options.md
@@ -3571,6 +3571,7 @@ Only change this setting if you really need to.
 ## registryAliases
 
 You can use the `registryAliases` object to set registry aliases.
+Renovate applies _all_ `registryAliases` objects, from top to bottom.
 
 This feature works with the following managers: