diff --git a/.changeset/purple-kiwis-work.md b/.changeset/purple-kiwis-work.md
new file mode 100644
index 00000000000..a085ebeac2e
--- /dev/null
+++ b/.changeset/purple-kiwis-work.md
@@ -0,0 +1,6 @@
+---
+"@clerk/react": patch
+"@clerk/shared": patch
+---
+
+Updated reference links in comments
diff --git a/packages/react/src/types.ts b/packages/react/src/types.ts
index 262d0aa9481..c769d58afac 100644
--- a/packages/react/src/types.ts
+++ b/packages/react/src/types.ts
@@ -49,7 +49,7 @@ export type ClerkProviderProps<TUi extends Ui = Ui> = Omit<IsomorphicClerkOption
    */
   __internal_bypassMissingPublishableKey?: boolean;
   /**
-   * Optional object to style your components. Will only affect [Clerk Components](https://clerk.com/docs/reference/components/overview) and not [Account Portal](https://clerk.com/docs/guides/customizing-clerk/account-portal) pages.
+   * Optional object to style your components. Will only affect [Clerk Components](https://clerk.com/docs/reference/components/overview) and not [Account Portal](https://clerk.com/docs/guides/account-portal/overview) pages.
    */
   appearance?: ExtractAppearanceType<TUi, Appearance>;
   /**
diff --git a/packages/shared/src/types/clerk.ts b/packages/shared/src/types/clerk.ts
index 426a2d5a45d..10a7be8d3a5 100644
--- a/packages/shared/src/types/clerk.ts
+++ b/packages/shared/src/types/clerk.ts
@@ -1074,7 +1074,7 @@ export type ClerkOptions = ClerkOptionsNavigation &
      */
     clerkUiCtor?: ClerkUiConstructor | Promise<ClerkUiConstructor>;
     /**
-     * Optional object to style your components. Will only affect [Clerk Components](https://clerk.com/docs/reference/components/overview) and not [Account Portal](https://clerk.com/docs/guides/customizing-clerk/account-portal) pages.
+     * Optional object to style your components. Will only affect [Clerk Components](https://clerk.com/docs/reference/components/overview) and not [Account Portal](https://clerk.com/docs/guides/account-portal/overview) pages.
      */
     // TODO @nikos
     appearance?: any;
diff --git a/packages/shared/src/types/user.ts b/packages/shared/src/types/user.ts
index 6957e8afd05..93d7a9ef4a4 100644
--- a/packages/shared/src/types/user.ts
+++ b/packages/shared/src/types/user.ts
@@ -54,7 +54,7 @@ declare global {
 /**
  * The `User` object holds all of the information for a single user of your application and provides a set of methods to manage their account.
  *
- * A user can be contacted at their primary email address or primary phone number. They can have more than one registered email address, but only one of them will be their primary email address. This goes for phone numbers as well; a user can have more than one, but only one phone number will be their primary. At the same time, a user can also have one or more external accounts by connecting to [social providers](https://clerk.com/docs/guides/configure/auth-strategies/social-connections/all-providers) such as Google, Apple, Facebook, and many more.
+ * A user can be contacted at their primary email address or primary phone number. They can have more than one registered email address, but only one of them will be their primary email address. This goes for phone numbers as well; a user can have more than one, but only one phone number will be their primary. At the same time, a user can also have one or more external accounts by connecting to [social providers](https://clerk.com/docs/guides/configure/auth-strategies/social-connections/overview) such as Google, Apple, Facebook, and many more.
  *
  * Finally, a `User` object holds profile data like the user's name, profile picture, and a set of [metadata](/docs/guides/users/extending) that can be used internally to store arbitrary information. The metadata are split into `publicMetadata` and `privateMetadata`. Both types are set from the [Backend API](https://clerk.com/docs/reference/backend-api){{ target: '_blank' }}, but public metadata can also be accessed from the [Frontend API](https://clerk.com/docs/reference/frontend-api){{ target: '_blank' }}.
  *