diff --git a/docs/user/site.rst b/docs/user/site.rst
index 15cb8afb5919399fb63b27924738f428d6e9a20d..a206c1d1ff2b14358451c07c09af334ddc573fae 100644
--- a/docs/user/site.rst
+++ b/docs/user/site.rst
@@ -231,6 +231,9 @@ mesh_on_lan \: optional
 
 autoupdater \: package
     Configuration for the autoupdater feature of Gluon.
+
+    The mirrors are checked in random order until the manifest could be downloaded
+    successfully or all mirrors have been tried.
     ::
 
       autoupdater = {