diff --git a/doc/config-reference/source/compute/hypervisor-vmware.rst b/doc/config-reference/source/compute/hypervisor-vmware.rst
index eaa798814e..f8a3490b3b 100644
--- a/doc/config-reference/source/compute/hypervisor-vmware.rst
+++ b/doc/config-reference/source/compute/hypervisor-vmware.rst
@@ -545,6 +545,12 @@ Sparse image by setting ``vmware_disktype`` to ``sparse``:
 The following table shows the ``vmware_ostype`` property that applies to
 each of the supported guest OS:
 
+.. note::
+
+   If a glance image has a ``vmware_ostype`` property which does not
+   correspond to a valid VMware guestId, VM creation will fail, and a warning
+   will be logged.
+
 .. list-table:: OpenStack Image service OS type settings
    :header-rows: 1