diff --git a/README.rst b/README.rst
index c682b23..657ca3e 100644
--- a/README.rst
+++ b/README.rst
@@ -1469,6 +1469,24 @@
           rbac:
             enabled: True
 
+Increase maximum number of allowed address pairs per instance
+-----------------------------------
+
+Neutron Server:
+
+.. code-block:: yaml
+
+    neutron:
+      server:
+        max_allowed_address_pair: 20
+
+Neutron generic node (compute or gateway):
+
+.. code-block:: yaml
+
+    neutron:
+      max_allowed_address_pair: 20
+
 Enhanced logging with logging.conf
 ----------------------------------