diff --git a/docs/guide/migration.md b/docs/guide/migration.md
index e82bd7630a740b..49a79edf76571c 100644
--- a/docs/guide/migration.md
+++ b/docs/guide/migration.md
@@ -328,6 +328,7 @@ The following options are deprecated and will be removed in the future:
 - `worker.rollupOptions`: renamed to `worker.rolldownOptions`
 - `build.commonjsOptions`: it is now no-op
 - `build.dynamicImportVarsOptions.warnOnError`: it is now no-op
+- `resolve.alias[].customResolver`: Use a custom plugin with `resolveId` hook instead
 
 ## General Changes [<Badge text="NRV" type="warning" />](#migration-from-v7)