diff --git a/docs/api/index.md b/docs/api/index.md
index 1e63d406b..40c449abf 100644
--- a/docs/api/index.md
+++ b/docs/api/index.md
@@ -1433,6 +1433,10 @@ isVisible(): boolean
 
 **Details:**
 
+::: warning
+`isVisible()` only works correctly if the wrapper is attached to the DOM using [`attachTo`](#attachto)
+:::
+
 ```js
 const Component = {
   template: `<div v-show="false"><span /></div>`