diff --git a/docs.json b/docs.json
index 2d971cdf..b760321c 100644
--- a/docs.json
+++ b/docs.json
@@ -898,6 +898,10 @@
       "source": "/404",
       "destination": "/404.html"
     },
+    {
+      "source": "/solutions/wallets/link-wallets/overview",
+      "destination": "/sdk/web/hooks/useWallets"
+    },
     {
       "source": "/solutions/technical-references/chain-support/",
       "destination": "https://status.sequence.info"
diff --git a/sdk/web/hooks/useWallets.mdx b/sdk/web/hooks/useWallets.mdx
index 186ccbf9..801e5fda 100644
--- a/sdk/web/hooks/useWallets.mdx
+++ b/sdk/web/hooks/useWallets.mdx
@@ -4,6 +4,19 @@ description: Hook for managing connected wallets
 sidebarTitle: useWallets
 ---
 
+## Features
+
+This hook provides a unified interface for managing connected wallets, both embedded (WaaS) and external wallets. The user is prompted to sign a transaction with their active wallet in order to link wallets enabling read-only functionality.
+
+Key features:
+- Get information about all connected wallets
+- Set a specific wallet as active
+- Disconnect wallets
+- View linked wallets for embedded wallets
+- Refresh the list of linked wallets
+
+For embedded wallets (Wallet-as-a-Service), the hook automatically fetches linked wallets if available. Linked wallets are additional wallets that have been connected to the primary embedded wallet.
+
 ## Import
 
 ```tsx
@@ -137,16 +150,5 @@ Function to disconnect a wallet by its address.
 
 Function to refresh the list of linked wallets. Useful after linking a new wallet.
 
-## Notes
-
-This hook provides a unified interface for managing connected wallets, both embedded (WaaS) and external wallets. 
-
-Key features:
-- Get information about all connected wallets
-- Set a specific wallet as active
-- Disconnect wallets
-- View linked wallets for embedded wallets
-- Refresh the list of linked wallets
 
-For embedded wallets (Wallet-as-a-Service), the hook automatically fetches linked wallets if available. Linked wallets are additional wallets that have been connected to the primary embedded wallet.