diff --git a/README.rst b/README.rst
index a8bfb88..d78b160 100644
--- a/README.rst
+++ b/README.rst
@@ -394,6 +394,32 @@
                     roles:
                     - custom-roles
 
+Multiple servers example
+
+.. code-block:: yaml
+
+  keystone:
+    client:
+      enabled: true
+      server:
+        keystone01:
+          admin:
+            host: 10.0.0.2
+            port: 5000
+            project: 'admin'
+            user: admin
+            password: 'workshop'
+            region_name: RegionOne
+            protocol: https
+        keystone02:
+          admin:
+            host: 10.0.0.3
+            port: 5000
+            project: 'admin'
+            user: admin
+            password: 'workshop'
+            region_name: RegionOne
+
 Documentation and Bugs
 ======================