diff --git a/README.rst b/README.rst
index a79e1f3..bd06ba5 100644
--- a/README.rst
+++ b/README.rst
@@ -55,6 +55,30 @@
         default_dashboard: 'admin'
         help_url: 'http://doc.domain.com'
 
+Dashboard settings with HORIZON_CONFIG dictionary:
+
+.. code-block:: yaml
+
+    horizon:
+      server:
+        enabled: true
+        horizon_config:
+          user_home: "openstack_dashboard.views.get_user_home"
+          ajax_queue_limit: 10
+          auto_fade_alerts:
+            delay: 3000
+            fade_duration: 1500
+            types:
+              - alert-success
+              - alert-info
+          help_url: "http://docs.openstack.org"
+          modal_backdrop: "static"
+          disable_password_reveal: True
+          password_validator:
+            regex: "^.{8,18}$"
+            help_text: "Password must be between 8 and 18 characters."
+            password_autocomplete: "off"
+
 Horizon with policy files metadata. With source mine you can obtain real
 time policy file state from targeted node (OpenStack control node),
 provided you have policy file published to specified grain key. Source