diff --git a/src/content/configuration/optimization.md b/src/content/configuration/optimization.md
index 01b785051b53..5a4f6c7cee4a 100644
--- a/src/content/configuration/optimization.md
+++ b/src/content/configuration/optimization.md
@@ -306,6 +306,8 @@ module.exports = {
 };
 ```
 
+W> `optimization.removeAvailableModules` reduces the performance of webpack, and will be disabled in `production` mode by default in next major release. Disable it in `production` mode if you want extra build performance.
+
 ## `optimization.removeEmptyChunks`
 
 `boolean = true`