diff --git a/docs/pages/component/events.mdx b/docs/pages/component/events.mdx
index afd2c0ec05..654cca67df 100644
--- a/docs/pages/component/events.mdx
+++ b/docs/pages/component/events.mdx
@@ -459,6 +459,8 @@ Example:
 
 Both the currentTime & seekTime are reported because the video player may not seek to the exact requested position in order to improve seek performance.
 
+Note: on iOS, when controls are enable, this callback is not reported. This is a known limitation.
+
 ### `onTimedMetadata`
 
 <PlatformsList types={['Android', 'iOS', 'visionOS']} />