diff --git a/docs/source/upgrade-guide/index.md b/docs/source/upgrade-guide/index.md
index b9b67fcf4d..7148dbb0ed 100644
--- a/docs/source/upgrade-guide/index.md
+++ b/docs/source/upgrade-guide/index.md
@@ -579,6 +579,27 @@ Also in the Storybook configuration {file}`.storybook/main.js`.
 ```{versionadded} @plone/registry 3.0.0-alpha.0
 ```
 
+### Add missing overrides to projects in `package.json`
+
+This will fix some issues with Hot Module Reload in projects.
+It's required in Volto `18.0.0-alpha.47` and later, otherwise the site breaks in development mode.
+Add this object to the `pnpm` key in your project {file}`package.json`.
+
+```json
+  "pnpm": {
+    "overrides": {
+			"@pmmmwh/react-refresh-webpack-plugin": "^0.5.15",
+			"react-refresh": "^0.14.2"
+    }
+  },
+```
+
+```{versionadded} Volto 18.0.0-alpha.47
+```
+
+```{versionadded} @plone/registry 3.0.0-alpha.0
+```
+
 ### Deprecation notices for Volto 18
 
 #### `@plone/generator-volto`
diff --git a/packages/volto/news/6446.documentation b/packages/volto/news/6446.documentation
new file mode 100644
index 0000000000..e03a0087d3
--- /dev/null
+++ b/packages/volto/news/6446.documentation
@@ -0,0 +1 @@
+Added upgrade guide fix for HMR. @sneridagh