diff --git a/doc/advanced-configuration.rst b/doc/advanced-configuration.rst
index bed186c7bb79b6e4fdc5447f27ee362875120989..97f5d86f7a1511a4e56e98b2eb8cdf5b2b23c683 100644
--- a/doc/advanced-configuration.rst
+++ b/doc/advanced-configuration.rst
@@ -58,6 +58,13 @@ Provisions must be taken outside of kolla for these names to map to the
 configured IP addresses. Using a DNS server or the /etc/hosts file are
 two ways to create this mapping.
 
+RabbitMQ Hostname Resolution
+============================
+
+RabbitMQ doesn't work with IP address, hence the IP address of api_interface
+should be resolvable by hostnames to make sure that all RabbitMQ Cluster
+hosts can resolve each others hostname beforehand.
+
 TLS Configuration
 =================