diff --git a/README.rst b/README.rst
index daae157..f1f5d5a 100644
--- a/README.rst
+++ b/README.rst
@@ -338,6 +338,38 @@
         enable_stack_abandon: true
         enable_stack_adopt: true
 
+
+Change files/directories permissions for heat service:
+=======================================
+In order to change file permissions the following should be set:
+
+'files' - block to set permissions for files.
+- full path to file
+- user ( default value is 'root' ) this parameter is optional.
+- group ( default value is 'heat' ) this parameter is optional
+- mode ( default value is '0640' ) this parameter is optional
+
+'directories' - block to set permissions for directories.
+- full path to directory
+- user ( default value is 'root' ) this parameter is optional
+- group ( default value is 'heat' ) this parameter is optional
+- mode ( default value is '0750' ) this parameter is optional
+
+.. code-block:: yaml
+
+    heat:
+      files:
+        /etc/heat/heat.conf:
+          user: 'root'
+          group: 'heat'
+          mode: '0750'
+      directories:
+        /etc/heat:
+          user: 'root'
+          group: 'heat'
+          mode: '0750'
+
+
 Upgrades
 ========