diff --git a/README.rst b/README.rst
index 94a1609..6fd2aa2 100644
--- a/README.rst
+++ b/README.rst
@@ -639,6 +639,62 @@
             track: connection
           servers:
             ...
+Implement rate limiting, to prevent excessive requests
+using 'format: listen' and acls/request/backend stick list
+
+.. code-block:: yaml
+
+  haproxy:
+    proxy:
+      listen:
+        nova_metadata_api:
+          options:
+          - httplog
+          rate_limit:
+            enabled: true
+            type: string
+            len: 36
+            size: 10m
+            duration: 60s
+            acls:
+              101:
+                enabled: true
+                value: acl too_many_requests_3 sc0_gpc0_rate() gt 3
+              102:
+                enabled: true
+                value: acl mark_seen sc0_inc_gpc0 gt 0
+              110:
+                enabled: true
+                value: acl x_instance_id hdr(x-instance-id) -i 4777e8e0-16e8-46ce-a3fe-0a1ad9b3ebdc
+              111:
+                enabled: true
+                value: acl x_instance_id hdr(x-instance-id) -i ca2395dd-f73f-4d43-8fe7-f7078a0920af
+              201:
+                enabled: true
+                value: acl too_many_requests_6 sc0_gpc0_rate() gt 6
+              202:
+                enabled: true
+                value: acl mark_seen sc0_inc_gpc0 gt 0
+              210:
+                enabled: true
+                value: acl x_tenant_id hdr(x-tenant-id) -i 2b76cc56a437404bb8cb6cb20dbb0ea4
+            tcp_request:
+              001:
+                enabled: true
+                value: tcp-request inspect-delay 5s
+              101:
+                enabled: true
+                value: tcp-request content track-sc0 hdr(x-instance-id) if ! too_many_requests_3
+              201:
+                enabled: true
+                value: tcp-request content track-sc0 hdr(x-tenant-id) if ! too_many_requests_6
+            use_backend:
+              101:
+                enabled: true
+                value: use_backend nova_metadata_api-rate_limit if mark_seen too_many_requests_3 x_instance_id
+              201:
+                enabled: true
+                value: use_backend nova_metadata_api-rate_limit if mark_seen too_many_requests_6 x_tenant_id
 
 
 Read more