diff --git a/guides/common/modules/proc_synchronizing-the-new-repositories.adoc b/guides/common/modules/proc_synchronizing-the-new-repositories.adoc
index 5d91dcf8291..87ad705ac6e 100644
--- a/guides/common/modules/proc_synchronizing-the-new-repositories.adoc
+++ b/guides/common/modules/proc_synchronizing-the-new-repositories.adoc
@@ -17,10 +17,13 @@ You must enable and synchronize the new {ProjectVersion} repositories before you
 ** *{RHEL} 9 (for x86_64 {endash} AppStream) (RPMs)*
 * Repositories required to upgrade {Project} clients:
 ** *{project-client-name}* for each {RHEL} version your clients are using
+** If you use Puppet to manage host configurations, *{project-client-name} OpenVox* for each {RHEL} version your clients are using
 . In the {ProjectWebUI}, navigate to *Content* > *Sync Status*.
 . Synchronize the following repositories:
 ** All repositories for version {ProjectVersion}
 ** *{project-client-name}* repositories for each {RHEL} version your clients are using
+. If you use Puppet to manage host configurations, manually update the content views for your hosts.
+Add the *{project-client-name} OpenVox* repository for the {RHEL} version your clients are using to the content views and publish and promote a new version of the content views.
 
 .Troubleshooting
 * Refresh the Red{nbsp}Hat subscription manifest to resolve issues with synchronizing repositories.
diff --git a/guides/common/modules/proc_upgrade-puppet-agent-to-openvox-agent.adoc b/guides/common/modules/proc_upgrade-puppet-agent-to-openvox-agent.adoc
new file mode 100644
index 00000000000..57959dd4328
--- /dev/null
+++ b/guides/common/modules/proc_upgrade-puppet-agent-to-openvox-agent.adoc
@@ -0,0 +1,32 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="upgrade-puppet-agent-to-openvox-agent"]
+= Upgrade Puppet agent 7 to OpenVox agent 8
+
+[role="_abstract"]
+If you use Puppet to configure hosts, you can upgrade Puppet agent to OpenVox agent.
+
+Puppet agent remains compatible with OpenVox in {Project} as a legacy alternative, but {Team} recommends to upgrade to OpenVox agent.
+For more information, see {ManagingConfigurationsPuppetDocURL}openvox-versions-supported-for-integration-with-{project-context}[OpenVox versions supported for integration with {Project}] in _{ManagingConfigurationsPuppetDocTitle}_.
+
+.Prerequisites
+* *{project-client-name} OpenVox* repository is enabled on the host.
+
+.Procedure
+* On your hosts, upgrade the `puppet-agent` agent package to `openvox-agent`:
+** On hosts running {EL} 8 and above:
++
+[options="nowrap" subs="+quotes,verbatim,attributes"]
+----
+# {client-package-update-el8} puppet-agent
+----
++
+** On hosts running {EL} 7:
++
+[options="nowrap" subs="+quotes,verbatim,attributes"]
+----
+# {client-package-update-el7} puppet-agent
+----
++
+You can also use remote execution to upgrade the package on multiple hosts.
+For more information, see {ManagingHostsDocURL}Upgrading_a_package_managing-hosts[Upgrading a package] in _{ManagingHostsDocTitle}_.
diff --git a/guides/doc-Upgrading_Project/master.adoc b/guides/doc-Upgrading_Project/master.adoc
index 0cf84446fe8..c1d46da0351 100644
--- a/guides/doc-Upgrading_Project/master.adoc
+++ b/guides/doc-Upgrading_Project/master.adoc
@@ -43,6 +43,8 @@ endif::[]
 
 ifdef::satellite[]
 include::common/modules/proc_refreshing-clients-of-insights-iop.adoc[leveloffset=+2]
+
+include::common/modules/proc_upgrade-puppet-agent-to-openvox-agent.adoc[leveloffset=+2]
 endif::[]
 
 ifndef::orcharhino,satellite[]
diff --git a/guides/doc-Upgrading_Project_Disconnected/master.adoc b/guides/doc-Upgrading_Project_Disconnected/master.adoc
index 9b927670fd5..c57fe763da1 100644
--- a/guides/doc-Upgrading_Project_Disconnected/master.adoc
+++ b/guides/doc-Upgrading_Project_Disconnected/master.adoc
@@ -34,6 +34,8 @@ include::common/modules/proc_upgrading-smartproxy-server.adoc[leveloffset=+2]
 include::common/modules/proc_upgrading-the-external-database-operating-system.adoc[leveloffset=+2]
 
 include::common/modules/proc_refreshing-clients-of-insights-iop.adoc[leveloffset=+2]
+
+include::common/modules/proc_upgrade-puppet-agent-to-openvox-agent.adoc[leveloffset=+2]
 endif::[]
 
 ifndef::orcharhino,satellite[]