diff --git a/docs/guide/migration.md b/docs/guide/migration.md
index c3e7be3a8a2c27..a787bee473b54c 100644
--- a/docs/guide/migration.md
+++ b/docs/guide/migration.md
@@ -52,6 +52,10 @@ If using ESM for SSR isn't possible in your project, you can set `ssr.format: 'c
 ## General Changes
 
 - JS file extensions in SSR and lib mode now use a valid extension (`js`, `mjs`, or `cjs`) for output JS entries and chunks based on their format and the package type.
+- Terser is now an optional dependency. If you are using `build.minify: 'terser'`, you need to install it.
+  ```shell
+  npm add -D terser
+  ```
 
 ### `import.meta.glob`