diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst
index 13daecda2d..7040e9ddbc 100644
--- a/doc/source/gerrit.rst
+++ b/doc/source/gerrit.rst
@@ -462,6 +462,10 @@ To rename a project:
 
      sudo invoke-rc.d zuul start
 
+#. Rename any associated groups whose names may have changed::
+
+     ssh -p 29418 review.openstack.org gerrit rename-group OLDNAME NEWNAME
+
 #. Merge the prepared Puppet configuration change, removing the
    original Jenkins jobs via the Jenkins WebUI later if needed.