diff --git a/README.rst b/README.rst
index 084c423..4d4d1ca 100644
--- a/README.rst
+++ b/README.rst
@@ -21,6 +21,8 @@
       server:
         enabled: true
         version: mitaka
+        allow_pagination: true
+        pagination_max_limit: 100
         bind:
           address: 172.20.0.1
           port: 9696
@@ -52,6 +54,11 @@
         audit:
           enabled: false
 
+Note: The pagination is useful to retrieve a large bunch of resources,
+because a single request may fail (timeout). This is enabled with both
+parameters *allow_pagination* and *pagination_max_limit* as shown above.
+
+
 Neutron VXLAN tenant networks with Network Nodes (with DVR for East-West
  and Network node for North-South)
 =========================================================================