diff --git a/README.rst b/README.rst
index 94a76c1..649b9a2 100644
--- a/README.rst
+++ b/README.rst
@@ -134,6 +134,21 @@
           user: octavia
           group: octavia
 
+Octavia policy rules:
+
+.. code-block:: yaml
+
+    octavia:
+      api:
+        policy:
+          context_is_admin: 'role:admin or role:load-balancer_admin'
+          admin_or_owner: 'is_admin:True or project_id:%(project_id)s'
+          load-balancer:read: 'rule:admin_or_owner'
+          load-balancer:read-global: 'is_admin:True'
+          load-balancer:write: 'rule:admin_or_owner'
+          load-balancer:read-quota: 'rule:admin_or_owner'
+          load-balancer:read-quota-global: 'is_admin:True'
+          load-balancer:write-quota: 'is_admin:True'
 
 Upgrades
 ========