diff --git a/docs/appkit/next/core/components.mdx b/docs/appkit/next/core/components.mdx
index 558abe49..ab2cddf0 100644
--- a/docs/appkit/next/core/components.mdx
+++ b/docs/appkit/next/core/components.mdx
@@ -6,7 +6,16 @@ import Components from '../../shared/components.mdx'
 import Table from '../../../components/Table'
 
 # Web Components
+:::warning
+If you are using React v19 and global components. Please add, before the component, the following directive to temporarily suppress TypeScript errors until the upgrade is fully supported:  
 
+```tsx
+{/* @ts-expect-error msg */}
+<appkit-button />
+```
+
+This will prevent TypeScript from reporting errors related to global component types.  
+:::
 <Components />
 
 ### `<appkit-wallet-button  />`
diff --git a/docs/appkit/next/core/installation.mdx b/docs/appkit/next/core/installation.mdx
index a969af21..cb074acf 100644
--- a/docs/appkit/next/core/installation.mdx
+++ b/docs/appkit/next/core/installation.mdx
@@ -140,6 +140,16 @@ Create a new project on Reown Cloud at https://cloud.reown.com and obtain a new
 
 ## Trigger the modal
 
+:::warning
+If you are using React v19 and global components. Please add, before the component, the following directive to temporarily suppress TypeScript errors until the upgrade is fully supported:  
+
+```tsx
+{/* @ts-expect-error msg */}
+<appkit-button />
+```
+
+This will prevent TypeScript from reporting errors related to global component types.  
+:::
 <PlatformTabs groupId="eth-lib" activeOptions={["wagmi", "ethers5","ethers","solana","bitcoin"]}>
 <PlatformTabItem value="wagmi">
 
diff --git a/docs/appkit/react/core/components.mdx b/docs/appkit/react/core/components.mdx
index 5f11a49d..44de2b90 100644
--- a/docs/appkit/react/core/components.mdx
+++ b/docs/appkit/react/core/components.mdx
@@ -6,7 +6,18 @@ import Table from '../../../components/Table'
 import Components from '../../shared/components.mdx'
 
 # Web Components
+## Trigger the modal
 
+:::warning
+If you are using React v19 and global components. Please add, before the component, the following directive to temporarily suppress TypeScript errors until the upgrade is fully supported:  
+
+```tsx
+{/* @ts-expect-error msg */}
+<appkit-button />
+```
+
+This will prevent TypeScript from reporting errors related to global component types.  
+:::
 <Components />
 
 ### `<appkit-wallet-button  />` 
diff --git a/docs/appkit/react/core/installation.mdx b/docs/appkit/react/core/installation.mdx
index 4e4839ab..90cc4b7a 100644
--- a/docs/appkit/react/core/installation.mdx
+++ b/docs/appkit/react/core/installation.mdx
@@ -144,6 +144,17 @@ Create a new project on reown Cloud at https://cloud.reown.com and obtain a new
 
 ## Trigger the modal
 
+:::warning
+If you are using React v19 and global components. Please add, before the component, the following directive to temporarily suppress TypeScript errors until the upgrade is fully supported:  
+
+```tsx
+{/* @ts-expect-error msg */}
+<appkit-button />
+```
+
+This will prevent TypeScript from reporting errors related to global component types.  
+:::
+
 <PlatformTabs groupId="eth-lib" activeOptions={["wagmi", "ethers5","ethers","solana","bitcoin"]}>
 <PlatformTabItem value="wagmi">