Fix broken links (#2278)

alexandratran · web-flow · commit 3ae9489257d7 · 2025-09-08T11:27:31.000+10:00
diff --git a/embedded-wallets/sdk/js/advanced/custom-authentication.mdx b/embedded-wallets/sdk/js/advanced/custom-authentication.mdx
@@ -42,7 +42,7 @@ You can only configure implicit login via modal, for JWT based logins, you need
 
 For the modal custom authentication, you need to pass the `modalConfig` object to the `Web3AuthOptions` object within the constructor.
 
-> **Read more about the `modalConfig` object in the [Whitelabel](../whitelabel) section.**
+> **Read more about the `modalConfig` object in the [Whitelabel](whitelabel.mdx) section.**
 
 ### Usage
 
diff --git a/embedded-wallets/sdk/js/advanced/whitelabel.mdx b/embedded-wallets/sdk/js/advanced/whitelabel.mdx
@@ -245,4 +245,4 @@ await web3auth.init()
 
 For complete control over the authentication interface, you can bypass the Web3Auth modal entirely and use the `connectTo` function. This allows you to create custom buttons that connect directly to specific auth providers.
 
-See the [Custom Authentication](../custom-authentication) section for detailed implementation instructions.
+See the [Custom Authentication](custom-authentication.mdx) section for detailed implementation instructions.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/custom-authentication.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/custom-authentication.mdx
@@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem'
 
 This guide focuses specifically on migrating custom authentication configurations from Web3Auth v7
 to v10. This covers the transition from "Verifiers" to "Connections" and "Grouped Connections". This
-is a supplementary guide to the main [v7 to v10 migration guide](../README.mdx).
+is a supplementary guide to the main [v7 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -180,5 +180,5 @@ client-side logic and provides a more robust way to manage authentication method
 
 ## Next Steps
 
-Return to the main [v7 to v10 migration guide](../README) to continue with other
+Return to the main [v7 to v10 migration guide](README.mdx) to continue with other
 migration aspects like method name changes and initialization updates.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/external-wallets.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/external-wallets.mdx
@@ -11,7 +11,7 @@ import TabItem from '@theme/TabItem'
 
 This guide focuses specifically on migrating external wallet adapter configurations from Web3Auth v7
 to v10. This is a supplementary guide to the main
-[v7 to v10 migration guide](../README.mdx).
+[v7 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -88,5 +88,5 @@ No configuration needed - everything works out of the box!
 
 ## Next Steps
 
-Return to the main [v7 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v7 to v10 migration guide](README.mdx) to continue with other
 migration aspects.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/wallet-services.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/wallet-services.mdx
@@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem'
 # Web3Auth v10 Wallet Services Migration Guide
 
 This guide focuses specifically on migrating Wallet Services functionality from Web3Auth v7 to v10.
-This is a supplementary guide to the main [v7 to v10 migration guide](../README.mdx).
+This is a supplementary guide to the main [v7 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -72,5 +72,5 @@ npm uninstall @web3auth/wallet-services-plugin
 
 ## Next Steps
 
-Return to the main [v7 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v7 to v10 migration guide](README.mdx) to continue with other
 migration aspects.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/whitelabeling.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v7-to-v10/whitelabeling.mdx
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'
 
 # Web3Auth v10 Whitelabeling Migration Guide
 
-This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v7 to v10. This is a supplementary guide to the main [v7 to v10 migration guide](../README.mdx).
+This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v7 to v10. This is a supplementary guide to the main [v7 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -137,4 +137,4 @@ This shift centralizes UI control on the dashboard and simplifies client-side SD
 
 ## Next Steps
 
-Return to the main [v7 to v10 migration guide](../README.mdx) to continue with other migration aspects like custom authentication and method name changes.
+Return to the main [v7 to v10 migration guide](README.mdx) to continue with other migration aspects like custom authentication and method name changes.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/custom-authentication.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/custom-authentication.mdx
@@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem'
 
 This guide focuses specifically on migrating custom authentication configurations from Web3Auth v8
 to v10. This covers the transition from "Verifiers" to "Connections" and "Grouped Connections". This
-is a supplementary guide to the main [v8 to v10 migration guide](../README.mdx).
+is a supplementary guide to the main [v8 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -176,5 +176,5 @@ client-side logic and provides a more robust way to manage authentication method
 
 ## Next Steps
 
-Return to the main [v8 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v8 to v10 migration guide](README.mdx) to continue with other
 migration aspects like MFA configurations and method renames.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/external-wallets.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/external-wallets.mdx
@@ -11,7 +11,7 @@ import TabItem from '@theme/TabItem'
 
 This guide focuses specifically on migrating external wallet adapter configurations from Web3Auth v8
 to v10. This is a supplementary guide to the main
-[v8 to v10 migration guide](../README.mdx).
+[v8 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -85,5 +85,5 @@ This provides a better user experience with no configuration required from devel
 
 ## Next Steps
 
-Return to the main [v8 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v8 to v10 migration guide](README.mdx) to continue with other
 migration aspects.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/wallet-services.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/wallet-services.mdx
@@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem'
 # Web3Auth v10 Wallet Services Migration Guide
 
 This guide focuses specifically on migrating Wallet Services functionality from Web3Auth v8 to v10.
-This is a supplementary guide to the main [v8 to v10 migration guide](../README.mdx).
+This is a supplementary guide to the main [v8 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -72,5 +72,5 @@ npm uninstall @web3auth/wallet-services-plugin
 
 ## Next Steps
 
-Return to the main [v8 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v8 to v10 migration guide](README.mdx) to continue with other
 migration aspects.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/whitelabeling.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v8-to-v10/whitelabeling.mdx
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'
 
 # Web3Auth v10 Whitelabeling Migration Guide
 
-This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v8 to v10. This is a supplementary guide to the main [v8 to v10 migration guide](../README.mdx).
+This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v8 to v10. This is a supplementary guide to the main [v8 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -57,4 +57,4 @@ This shift centralizes UI control on the dashboard and simplifies client-side SD
 
 ## Next Steps
 
-Return to the main [v8 to v10 migration guide](../README.mdx) to continue with other migration aspects like Smart Account functionality, custom authentication, and MFA configurations.
+Return to the main [v8 to v10 migration guide](README.mdx) to continue with other migration aspects like Smart Account functionality, custom authentication, and MFA configurations.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/custom-authentication.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/custom-authentication.mdx
@@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem'
 
 This guide focuses specifically on migrating custom authentication configurations from Web3Auth v9
 to v10. This covers the transition from "Verifiers" to "Connections" and "Grouped Connections". This
-is a supplementary guide to the main [v9 to v10 migration guide](../README.mdx).
+is a supplementary guide to the main [v9 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -180,5 +180,5 @@ client-side logic and provides a more robust way to manage authentication method
 
 ## Next Steps
 
-Return to the main [v9 to v10 migration guide](../README) to continue with other
+Return to the main [v9 to v10 migration guide](README.mdx) to continue with other
 migration aspects like MFA configurations and method renames.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/smart-accounts.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/smart-accounts.mdx
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'
 
 # Web3Auth v10 Smart Account Migration Guide
 
-This guide focuses specifically on migrating Smart Account configurations from Web3Auth v9 to v10. This is a supplementary guide to the main [v9 to v10 migration guide](../README.mdx).
+This guide focuses specifically on migrating Smart Account configurations from Web3Auth v9 to v10. This is a supplementary guide to the main [v9 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -96,4 +96,4 @@ If you want to override the Smart Account provider, bundler, paymaster, or payma
 
 ## Next Steps
 
-Return to the main [v9 to v10 migration guide](../README.mdx) to continue with other migration aspects like MFA configurations and method renames.
+Return to the main [v9 to v10 migration guide](README.mdx) to continue with other migration aspects like MFA configurations and method renames.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/wallet-services.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/wallet-services.mdx
@@ -10,7 +10,7 @@ import TabItem from '@theme/TabItem'
 # Web3Auth v10 Wallet Services Migration Guide
 
 This guide focuses specifically on migrating Wallet Services functionality from Web3Auth v9 to v10.
-This is a supplementary guide to the main [v9 to v10 migration guide](../README.mdx).
+This is a supplementary guide to the main [v9 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -72,5 +72,5 @@ npm uninstall @web3auth/wallet-services-plugin
 
 ## Next Steps
 
-Return to the main [v9 to v10 migration guide](../README.mdx) to continue with other
+Return to the main [v9 to v10 migration guide](README.mdx) to continue with other
 migration aspects.
diff --git a/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/whitelabeling.mdx b/embedded-wallets/sdk/js/migration-guides/modal/v9-to-v10/whitelabeling.mdx
@@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'
 
 # Web3Auth v10 Whitelabeling Migration Guide
 
-This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v9 to v10. This is a supplementary guide to the main [v9 to v10 migration guide](../README.mdx).
+This guide focuses specifically on migrating whitelabeling and UI customization configurations from Web3Auth v9 to v10. This is a supplementary guide to the main [v9 to v10 migration guide](README.mdx).
 
 ## Overview
 
@@ -57,4 +57,4 @@ This shift centralizes UI control on the dashboard and simplifies client-side SD
 
 ## Next Steps
 
-Return to the main [v9 to v10 migration guide](../README.mdx) to continue with other migration aspects like Smart Account functionality, custom authentication, and MFA configurations.
+Return to the main [v9 to v10 migration guide](README.mdx) to continue with other migration aspects like Smart Account functionality, custom authentication, and MFA configurations.
diff --git a/src/pages/tutorials/create-custom-caveat-enforcer.md b/src/pages/tutorials/create-custom-caveat-enforcer.md
@@ -10,7 +10,7 @@ author: MetaMask Developer Relations
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-This tutorial walks you through creating a custom [caveat enforcer](/delegation-toolkit/concepts/delegation/caveat-enforcers) and applying it to a [delegation](/delegation-toolkit/concepts/delegation/).
+This tutorial walks you through creating a custom [caveat enforcer](/delegation-toolkit/development/concepts/delegation/caveat-enforcers) and applying it to a [delegation](/delegation-toolkit/concepts/delegation/).
 
 The MetaMask Delegation Toolkit includes [out-of-the-box caveat enforcers](/delegation-toolkit/reference/caveats) that define rules and restrictions for common use cases.
 For more specific control or other use cases, you can create custom caveat enforcers.
@@ -19,7 +19,7 @@ In this tutorial, you'll create and apply a caveat enforcer that only allows a d
 ## Prerequisites
 
 - [Install and set up the Delegation Toolkit](/delegation-toolkit/get-started/install) in your project.
-- [Configure the Delegation Toolkit.](/delegation-toolkit/guides/configure)
+- [Configure the Delegation Toolkit.](/delegation-toolkit/development/guides/configure)
 - [Install Foundry and Forge.](https://getfoundry.sh/introduction/installation)
 - Get an [Infura API key](/developer-tools/dashboard/get-started/create-api) from the MetaMask Developer dashboard.
 - Have a MetaMask account with some Sepolia ETH to deploy your contract.
@@ -92,7 +92,7 @@ The Forge CLI will display the address of the deployed caveat enforcer.
 ### 3. Apply the caveat enforcer
 
 Specify the address of the deployed `AfterTimestampEnforcer.sol` contract, add it to the caveat builder, and create a delegation.
-Learn more about [applying caveats to a delegation](/delegation-toolkit/guides/delegation/restrict-delegation).
+Learn more about [applying caveats to a delegation](/delegation-toolkit/development/guides/delegation/restrict-delegation).
 
 The following code snippet uses the custom caveat enforcer to create a delegation granting
 a 1,000,000 wei allowance that becomes spendable one hour after it is created:
@@ -158,4 +158,4 @@ export const delegatorSmartAccount = await toMetaMaskSmartAccount({
 You've successfully created, deployed, and applied a custom caveat enforcer!
 
 For production use cases, you might need to add additional caveats to restrict the delegation further.
-Learn more about [caveat enforcers](/delegation-toolkit/concepts/delegation/caveat-enforcers).
+Learn more about [caveat enforcers](/delegation-toolkit/development/concepts/delegation/caveat-enforcers).
diff --git a/src/pages/tutorials/use-passkey-as-backup-signer.md b/src/pages/tutorials/use-passkey-as-backup-signer.md
@@ -15,7 +15,7 @@ An externally owned account (EOA) uses the secp256k1 elliptic curve to generate
 In contrast, a passkey (WebAuthn credential) uses the secp256r1 (P-256) elliptic curve to generate key pairs and signatures.
 Passkeys eliminate the need for traditional seed phrases that are difficult to remember, enabling a more seamless and secure way for users to access their web3 wallets.
 
-MetaMask Smart Accounts offer a [Hybrid implementation](/delegation-toolkit/concepts/smart-accounts#hybrid-smart-account), which supports signature validation for both secp256k1 and secp256r1 curves.
+MetaMask Smart Accounts offer a [Hybrid implementation](/delegation-toolkit/concepts/smart-accounts/#hybrid-smart-account), which supports signature validation for both secp256k1 and secp256r1 curves.
 This allows you to add a passkey as a backup signer for your smart account.
 
 You can add passkeys during smart account creation or after the account has been deployed.
@@ -25,8 +25,8 @@ This tutorial walks you through adding a passkey signer to an already deployed s
 
 - [Install and set up the Delegation Toolkit](/delegation-toolkit/get-started/install) in your project.
 - [Install Ox SDK](https://oxlib.sh/#installation).
-- [Configure the Delegation Toolkit](/delegation-toolkit/guides/configure).
-- [Create and deploy a Hybrid smart account,](/delegation-toolkit/guides/smart-accounts/create-smart-account) with a signatory from a private key.
+- [Configure the Delegation Toolkit](/delegation-toolkit/development/guides/configure).
+- [Create and deploy a Hybrid smart account,](/delegation-toolkit/development/guides/smart-accounts/create-smart-account) with a signatory from a private key.
 
 ## Steps
 
@@ -61,7 +61,7 @@ const bundlerClient = createBundlerClient({
 
 ### 3. Create a Hybrid smart account
 
-Configure the same [Hybrid smart account](/delegation-toolkit/guides/smart-accounts/create-smart-account#create-a-hybrid-smart-account) that you created and deployed as a [prerequisite](#prerequisites).
+Configure the same [Hybrid smart account](/delegation-toolkit/development/guides/smart-accounts/create-smart-account/#create-a-hybrid-smart-account) that you created and deployed as a [prerequisite](#prerequisites).
 The Hybrid implementation supports adding additional passkey signers.
 
 ```typescript

Original file line number	Diff line number	Diff line change
`@@ -245,4 +245,4 @@ await web3auth.init()`
`245`	`245`
`246`	`246`	For complete control over the authentication interface, you can bypass the Web3Auth modal entirely and use the `connectTo` function. This allows you to create custom buttons that connect directly to specific auth providers.
`247`	`247`
`248`		`-See the [Custom Authentication](../custom-authentication) section for detailed implementation instructions.`
	`248`	`+See the [Custom Authentication](custom-authentication.mdx) section for detailed implementation instructions.`