diff --git a/README.rst b/README.rst
index 8b27119..a4f905d 100644
--- a/README.rst
+++ b/README.rst
@@ -262,6 +262,19 @@
                   test_policy_rule2:
                     metric_pattern: 'foo2.*'
 
+Configuration of policy.json file:
+
+.. code-block:: yaml
+
+  gnocchi:
+    server:
+      ...
+      policy:
+        'resource_owner': 'project_id:%(project_id)s'
+        'get status': 'role:admin'
+        # Add key without value to remove line from policy.json
+        'list resource type':
+
 =======
 Gnocchi logging configuration
 ----------------------------------