diff --git a/docs/api/puppeteer.waitforselectoroptions.root.md b/docs/api/puppeteer.waitforselectoroptions.root.md
index 3b2aa5d7e15ad..d8a2b946f28e4 100644
--- a/docs/api/puppeteer.waitforselectoroptions.root.md
+++ b/docs/api/puppeteer.waitforselectoroptions.root.md
@@ -4,6 +4,10 @@ sidebar_label: WaitForSelectorOptions.root
 
 # WaitForSelectorOptions.root property
 
+> Warning: This API is now obsolete.
+>
+> Do not use. Use the [ElementHandle.waitForSelector()](./puppeteer.elementhandle.waitforselector.md)
+
 **Signature:**
 
 ```typescript
diff --git a/src/common/IsolatedWorld.ts b/src/common/IsolatedWorld.ts
index 0550bfd10aba1..6699091688fdf 100644
--- a/src/common/IsolatedWorld.ts
+++ b/src/common/IsolatedWorld.ts
@@ -77,6 +77,9 @@ export interface WaitForSelectorOptions {
    * @defaultValue `30000` (30 seconds)
    */
   timeout?: number;
+  /**
+   * @deprecated Do not use. Use the {@link ElementHandle.waitForSelector}
+   */
   root?: ElementHandle<Node>;
 }