diff --git a/doc/source/install-guide/configure-nova.rst b/doc/source/install-guide/configure-nova.rst
index f7656e464f..61e48bd72f 100644
--- a/doc/source/install-guide/configure-nova.rst
+++ b/doc/source/install-guide/configure-nova.rst
@@ -105,6 +105,28 @@ multipath support in nova through a configuration override:
       libvirt:
           iscsi_use_multipath: true
 
+Shared storage and synchronized UID/GID
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Deployers can specify a custom UID for the nova user and GID for the nova group
+to ensure they are identical on each host. This is helpful when using shared
+storage on compute nodes because it allows instances to migrate without
+filesystem ownership failures.
+
+By default, Ansible will create the nova user and group without specifying the
+UID or GID. To specify custom values for the UID/GID, set the following
+Ansible variables:
+
+.. code-block:: yaml
+
+    nova_system_user_uid = <specify a UID>
+    nova_system_group_gid = <specify a GID>
+
+**WARNING:** Setting this value **after** deploying an environment with
+OpenStack-Ansible can cause failures, errors, and general instability. These
+values should only be set once **before** deploying an OpenStack environment
+and then never changed.
+
 --------------
 
 .. include:: navigation.txt
diff --git a/releasenotes/notes/conditional-nova-uid-gid-f75c1faa0c3da575.yaml b/releasenotes/notes/conditional-nova-uid-gid-f75c1faa0c3da575.yaml
new file mode 100644
index 0000000000..dd8e433c59
--- /dev/null
+++ b/releasenotes/notes/conditional-nova-uid-gid-f75c1faa0c3da575.yaml
@@ -0,0 +1,4 @@
+---
+features:
+  - Deployers can optionally set a UID and/or GID for the nova user and group.
+    This is helpful for environments with shared storage.