diff --git a/doc/source/install-guide/configure-cinder-az.rst b/doc/source/install-guide/configure-cinder-az.rst
index c27e9c756e..3f1a3684aa 100644
--- a/doc/source/install-guide/configure-cinder-az.rst
+++ b/doc/source/install-guide/configure-cinder-az.rst
@@ -5,7 +5,8 @@ Availability zones
 
 Multiple availability zones can be created to manage Block Storage
 storage hosts. Edit the
-``/etc/openstack_deploy/openstack_user_config.yml`` file to set up
+``/etc/openstack_deploy/openstack_user_config.yml`` and
+``/etc/openstack_deploy/user_variables.yml`` files to set up
 availability zones.
 
 #. For each cinder storage host, configure the availability zone under
@@ -19,7 +20,9 @@ availability zones.
    *``cinderAZ_2``*
 
 #. If more than one availability zone is created, configure the default
-   availability zone for scheduling volume creation:
+   availability zone for all the hosts by creating a
+   ``cinder_default_availability_zone`` in your
+   ``/etc/openstack_deploy/user_variables.yml``
 
    .. code-block:: yaml
 
@@ -27,10 +30,11 @@ availability zones.
 
    Replace *``CINDERAZ_DEFAULT``* with a suitable name. For example,
    *``cinderAZ_1``*. The default availability zone should be the same
-   for all cinder storage hosts.
+   for all cinder hosts.
 
    If the ``cinder_default_availability_zone`` is not defined, the
-   default variable will be used.
+   default variable will be used (nova). This could make horizon's
+   volume creation fail.
 
 --------------