diff --git a/modules/virt-hot-plugging-cpu.adoc b/modules/virt-hot-plugging-cpu.adoc
new file mode 100644
index 000000000000..73cdd7d1f226
--- /dev/null
+++ b/modules/virt-hot-plugging-cpu.adoc
@@ -0,0 +1,21 @@
+// Module included in the following assemblies:
+//
+// * virt/virtual_machines/virt-edit-vms.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="virt-hot-plugging-cpu_{context}"]
+
+= Hot plugging CPUs on a virtual machine
+
+You can increase or decrease the number of CPU sockets allocated to a virtual machine (VM) without having to restart the VM by using the {product-title} web console.
+
+.Procedure
+
+. Navigate to *Virtualization* -> *VirtualMachines*.
+. Select the required VM to open the *VirtualMachine details* page.
+. On the *Configuration* tab, click *Edit CPU|Memory*.
+. Select the *vCPU* radio button.
+. Enter the desired number of vCPU sockets and click *Save*.
++
+If the VM is migratable, a live migration is triggered. If not, or if the changes cannot be live-updated, a `RestartRequired` condition is added to the VM.
+
diff --git a/virt/virtual_machines/virt-edit-vms.adoc b/virt/virtual_machines/virt-edit-vms.adoc
index a3a824ad49e8..baf8b5fe7b4e 100644
--- a/virt/virtual_machines/virt-edit-vms.adoc
+++ b/virt/virtual_machines/virt-edit-vms.adoc
@@ -15,6 +15,7 @@ To edit a VM to configure disk sharing by using virtual disks or LUN, see xref:.
 endif::openshift-rosa,openshift-dedicated[]
 
 include::modules/virt-hot-plugging-memory.adoc[leveloffset=+1]
+include::modules/virt-hot-plugging-cpu.adoc[leveloffset=+1]
 include::modules/virt-editing-vm-cli.adoc[leveloffset=+1]
 
 include::modules/virt-add-disk-to-vm.adoc[leveloffset=+1]