diff --git a/site/docs/pages/guides/troubleshooting.mdx b/site/docs/pages/guides/troubleshooting.mdx
index 7ee7014d5c..9b0c4af21b 100644
--- a/site/docs/pages/guides/troubleshooting.mdx
+++ b/site/docs/pages/guides/troubleshooting.mdx
@@ -46,7 +46,7 @@ This guide covers common issues you may encounter while using OnchainKit. If you
 ### Provider Configuration
 - **Missing OnchainKitProvider**
   - Error: "OnchainKit context not found"
-  - Solution: Wrap your app with OnchainKitProvider and configure properly:
+  - Solution: Wrap your app with OnchainKitProvider and [configure](/getting-started) properly:
   ```tsx
   import { OnchainKitProvider } from '@coinbase/onchainkit';
   import { base } from 'viem/chains';
@@ -68,7 +68,7 @@ This guide covers common issues you may encounter while using OnchainKit. If you
   - Error: "Unable to connect wallet"
   - Solutions:
     - Verify wallet extension is installed and unlocked
-    - Check supported chains configuration
+    - Check [supported chains configuration](/wallet/wallet)
     - Ensure proper network selection in wallet
     - Verify RPC endpoints are accessible
 
@@ -86,8 +86,8 @@ This guide covers common issues you may encounter while using OnchainKit. If you
   - Solutions:
     - Verify sufficient balance for gas
     - Check transaction parameters are valid
-    - Ensure proper network configuration
-    - Consider using sponsored transactions
+    - Ensure proper network [configuration](/transaction/tranasaction)
+    - Consider using [sponsored transactions](/transaction/sponsored-transaction)
 
 ### Identity Components