diff --git a/doc/libervia-cli/pubsub_cache.rst b/doc/libervia-cli/pubsub_cache.rst
index bfc7369e..ec5ec19b 100644
--- a/doc/libervia-cli/pubsub_cache.rst
+++ b/doc/libervia-cli/pubsub_cache.rst
@@ -90,6 +90,16 @@ Reset the whole pubsub cache. This means that all nodes and all them items will
 from cache. After this command, cache will be re-filled progressively as if it where a new
 one.
 
+.. note::
+
+    Use this command with caution: even if cache will be re-constructed with time, that
+    means that items will have to be retrieved again, that may be resource intensive both
+    for your machine and for the pubsub services which will be used. That also means that
+    searching items will return less results until all desired items are cached again.
+
+    Also note that all items of cached nodes are retrieved, even if you have previously
+    purged items, they will be retrieved again.
+
 example
 -------