diff --git a/docs/angular/build-options.md b/docs/angular/build-options.md
index 2f708c5e644..7c179cbdd6b 100644
--- a/docs/angular/build-options.md
+++ b/docs/angular/build-options.md
@@ -484,6 +484,14 @@ import { Component } from '@angular/core';
 export class TestComponent {}
 ```
 
+10. If you are using VSCode it is recommended to ignore the `@ionic/angular/common` and `@ionic/angular` module specifiers for import recommendations.
+
+```json title=".vscode/settings.json"
+{
+  "typescript.preferences.autoImportFileExcludePatterns": ["@ionic/angular/common", "@ionic/angular"]
+}
+```
+
 ### NgModule-based Applications
 
 Follow these steps if your Angular application is still using the NgModule architecture, but you want to adopt Ionic UI components as standalone components now.
@@ -653,3 +661,11 @@ import { TestComponent } from './test.component';
   declarations: [TestComponent]
 })
 ```
+
+10. If you are using VSCode it is recommended to ignore the `@ionic/angular/common` and `@ionic/angular` module specifiers for import recommendations.
+
+```json title=".vscode/settings.json"
+{
+  "typescript.preferences.autoImportFileExcludePatterns": ["@ionic/angular/common", "@ionic/angular"]
+}
+```