diff --git a/README.rst b/README.rst
index 9acaebb..241691c 100644
--- a/README.rst
+++ b/README.rst
@@ -514,6 +514,17 @@
             param2: value
         ....
 
+Configuration of policy.json file
+
+.. code-block:: yaml
+
+
+    keystone:
+      server:
+        ....
+        policy:
+          admin_or_token_subject: 'rule:admin_required or rule:token_subject'
+
 Usage
 =====