diff --git a/doc/PLUGINS.md b/doc/PLUGINS.md
index 644f3a254..ac115d8c2 100644
--- a/doc/PLUGINS.md
+++ b/doc/PLUGINS.md
@@ -1198,6 +1198,9 @@ Return a custom error to the request sender:
 }
 ```
 
+Note: The `rpc_command` hook is chainable. If two or more plugins try to
+replace/result/error the same `method`, only the first plugin in the chain
+will be respected. Others will be ignored and a warning will be logged.
 
 ### `custommsg`