diff --git a/cookbook/logging/channels_handlers.rst b/cookbook/logging/channels_handlers.rst
index d123e0d489f..40e9eef3349 100644
--- a/cookbook/logging/channels_handlers.rst
+++ b/cookbook/logging/channels_handlers.rst
@@ -95,6 +95,10 @@ in all environments, or just ``config_prod.yml`` to happen only in ``prod``:
             ),
         ));
 
+.. caution::
+
+    The 'channels' configuration only works for top level handlers. Handlers that are nested inside a Group, Buffer, Filter, FingersCrossed, or other such Handler will ignore this configuration and will process every message passed to them.
+
 YAML Specification
 ------------------