diff --git a/docs/config/index.md b/docs/config/index.md
index 09b5ee1171b03d..b7cba23e2bce5f 100644
--- a/docs/config/index.md
+++ b/docs/config/index.md
@@ -787,6 +787,8 @@ export default defineConfig({
 
   Set to `false` to disable minification, or specify the minifier to use. The default is [Esbuild](https://github.com/evanw/esbuild) which is 20 ~ 40x faster than terser and only 1 ~ 2% worse compression. [Benchmarks](https://github.com/privatenumber/minification-benchmarks)
 
+  Note the `build.minify` option is not available when using the `'es'` format in lib mode.
+
 ### build.terserOptions
 
 - **Type:** `TerserOptions`