diff --git a/README.rst b/README.rst
index cc6f92b..7e3b28d 100644
--- a/README.rst
+++ b/README.rst
@@ -399,6 +399,20 @@
   glance image-update --property hw_scsi_model=virtio-scsi <image>
   glance image-update --property hw_disk_bus=scsi <image>
 
+libvirt CPU mode
+----------------
+
+Allow setting the model of CPU that is exposed to a VM. This allows better
+support live migration between hypervisors with different hardware, among other
+things. Defaults to host-passthrough.
+
+.. code-block:: yaml
+
+  nova:
+    compute:
+      cpu_mode: host-model
+
+
 Documentation and Bugs
 ======================