diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index 7fa8fbf..35ca45b 100644
--- a/docs/troubleshooting.rst
+++ b/docs/troubleshooting.rst
@@ -35,6 +35,9 @@ promiscuous IP addresses, such as cloud, VPN and public proxy services, might be
 subject to significantly stricter limits for anonymous access. However,
 logged-in accesses (see :option:`--login`) do not seem to be affected.
 
+Instaloader allows to adjust the rate controlling behavior by overriding
+:class:`instaloader.RateController`.
+
 Too many queries in the last time
 ---------------------------------
 
@@ -42,6 +45,9 @@ Too many queries in the last time
 rate limit has almost been reached, according to Instaloader's own rate
 accounting mechanism.
 
+Instaloader allows to adjust the rate controlling behavior by overriding
+:class:`instaloader.RateController`.
+
 Private but not followed
 ------------------------