diff --git a/doc/source/reference/message-queues/rabbitmq.rst b/doc/source/reference/message-queues/rabbitmq.rst
index ac56539526d3a1d9c4d482db01c907c083eb6e68..1777329aa201d8abbbf3cba411f008e2c07b542e 100644
--- a/doc/source/reference/message-queues/rabbitmq.rst
+++ b/doc/source/reference/message-queues/rabbitmq.rst
@@ -180,6 +180,9 @@ therefore RabbitMQ version 3.13).
 
    This command should be run from the Antelope release.
 
+   Note that this command is NOT idempotent. See "RabbitMQ versions" below for
+   an alternative approach.
+
 .. code-block:: console
 
    kolla-ansible rabbitmq-upgrade 3.12