diff --git a/docs/config/index.md b/docs/config/index.md
index 6f85e92e58e082..4e8a71a436dd3a 100644
--- a/docs/config/index.md
+++ b/docs/config/index.md
@@ -557,6 +557,13 @@ export default async ({ command, mode }) => {
 - **Default:** `500`
 
   Limit for chunk size warnings (in kbs).
+  
+### build.watch
+
+- **Type:** [`WatcherOptions`](https://rollupjs.org/guide/en/#watch-options)`| null`
+- **Default:** `null`
+
+  Set to `{}` to enable rollup watcher. This is mostly used in cases that involve build-only plugins or integrations processes.
 
 ## Dep Optimization Options
 
diff --git a/docs/guide/build.md b/docs/guide/build.md
index 0f8ea3f681f25e..dd0c940e2fbf50 100644
--- a/docs/guide/build.md
+++ b/docs/guide/build.md
@@ -46,6 +46,21 @@ module.exports = {
 
 For example, you can specify multiple Rollup outputs with plugins that are only applied during build.
 
+## Rebuild on files changes
+
+You can enable rollup watcher with `vite build --watch`. Or, you can directly adjust the underlying [`WatcherOptions`](https://rollupjs.org/guide/en/#watch-options) via `build.watch`:
+
+```js
+// vite.config.js
+module.exports = {
+  build: {
+    watch: {
+      // https://rollupjs.org/guide/en/#watch-options
+    }
+  }
+}
+```
+
 ## Multi-Page App
 
 Suppose you have the following source code structure: