diff --git a/doc/libervia-cli/pubsub.rst b/doc/libervia-cli/pubsub.rst
index ef69845c..62f7de98 100644
--- a/doc/libervia-cli/pubsub.rst
+++ b/doc/libervia-cli/pubsub.rst
@@ -195,7 +195,7 @@ following command::
   $ li pubsub subscriptions --public -s pierre@example.net
 
 affiliations
-=============
+============
 
 Retrieve affiliations for all nodes at a service.
 
@@ -212,6 +212,20 @@ Retrieve affiliation for the ``notes`` node::
 
   $ li pubsub affiliations -s pubsub@example.net -n notes
 
+reference
+=========
+
+Send a reference (e.g. a mention) of a pubsub item to an entity.
+
+example
+-------
+
+Pierre send a reference to Louise to indicate that she has been mentioned in his blog post
+with ID ``from-paris-to-noumea-abcd``::
+
+  $ li pubsub reference -s pierre@example.net -n urn:xmpp:microblog:0 -i from-paris-to-noumea-abcd louise@example.org
+
+
 search
 ======