diff --git a/doc/manual/advanced-topics/distributed-builds.xml b/doc/manual/advanced-topics/distributed-builds.xml
index bbb573e35..ce2e077ed 100644
--- a/doc/manual/advanced-topics/distributed-builds.xml
+++ b/doc/manual/advanced-topics/distributed-builds.xml
@@ -180,4 +180,8 @@ builders = @/etc/nix/machines
causes the list of machines in /etc/nix/machines
to be included. (This is the default.)
+If you want the builders to use caches, you likely want to set
+the option builders-use-substitutes
+in your local nix.conf.
+