diff --git a/src/components/img/img.ts b/src/components/img/img.ts
index c00d8265c4..6c591dd623 100644
--- a/src/components/img/img.ts
+++ b/src/components/img/img.ts
@@ -28,6 +28,8 @@ import { Platform } from '../../platform/platform';
  * of images within a scrollable area, then `ion-img` would be better suited
  * for the job.
  *
+ * > Note: `ion-img` is only meant to be used inside of [virtual-scroll](/docs/v2/api/components/virtual-scroll/VirtualScroll/)
+ *
  *
  * ### Lazy Loading
  *