Start free

@clerk/nextjs breaking changes

Every breaking API change we have recorded in @clerk/nextjs on npm: 72 breaking changes in 4 versions. Below are its newest 4 versions, removals and renames first, each with its source.

Newest change March 3, 2026

On this page

7.0.0

33 breaking changes, first published March 3, 2026.

  • Removed experimental:CheckoutButtonProps
    CheckoutButtonProps was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed experimental:PlanDetailsButtonProps
    PlanDetailsButtonProps was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed experimental:SubscriptionDetailsButtonProps
    SubscriptionDetailsButtonProps was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed Protect
    Protect was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed server:ClerkMiddlewareAuthObject
    Use ClerkMiddlewareSessionAuthObject instead. npmjs.com
  • Removed SignedIn
    SignedIn was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed SignedOut
    SignedOut was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed UseOrganizationCreationDefaultsParams
    UseOrganizationCreationDefaultsParams was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Removed UseOrganizationCreationDefaultsReturn
    UseOrganizationCreationDefaultsReturn was removed in @clerk/nextjs 7.0.0 npmjs.com
  • Signature changed AuthenticateWithRedirectCallback
    Was export {AuthenticateWithRedirectCallback, ClerkDegraded, ClerkFailed, ClerkLoaded, ClerkLoading, RedirectToCreateOrganization, RedirectToOrganizationProfile, RedirectToSignIn, RedirectToSignUp, RedirectToTasks, RedirectToUserProfile}... npmjs.com

And 23 more in this version.

6.38.0

15 breaking changes, first published February 18, 2026.

  • Signature changed APIKeys
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed CreateOrganization
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed GoogleOneTap
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed OrganizationList
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed OrganizationSwitcher
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed PricingTable
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignInButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignInWithMetamaskButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignOutButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignUpButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com

And 5 more in this version.

6.37.0

10 breaking changes, first published January 28, 2026.

  • Signature changed useClerk
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useEmailLink
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useOrganization
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useOrganizationList
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useReverification
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useSession
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useSessionList
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useSignIn
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useSignUp
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com
  • Signature changed useUser
    Was export {useAuth, useClerk, useEmailLink, useOrganization, useOrganizationList, useReverification, useSession, useSessionList, useSignIn, useSignUp, useUser} from './client-boundary/hooks'; now export {useAuth, useClerk, useEmailLink... npmjs.com

6.36.0

14 breaking changes, first published December 5, 2025.

  • Signature changed APIKeys
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed CreateOrganization
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed GoogleOneTap
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed OrganizationList
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed OrganizationSwitcher
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed PricingTable
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignInButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignInWithMetamaskButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignOutButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com
  • Signature changed SignUpButton
    Was export {APIKeys, CreateOrganization, GoogleOneTap, OrganizationList, OrganizationProfile, OrganizationSwitcher, PricingTable, SignIn, SignInButton, SignInWithMetamaskButton, SignOutButton, SignUp, SignUpButton, TaskChooseOrganization... npmjs.com

And 4 more in this version.

Check your code

These are the changes. To see which of them reach your code, scan a public repository, or have your coding agent call check_code with your manifest or lockfile over MCP. The API reads every change in every version, not only the newest. On Team and up, a fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys.

Put your code on continuous management.

Scan a public repository now, or give your agent one line.

See how out of date your code is.

Any public GitHub repository. No sign-in.

Tell your agent what changed since it was trained.

claude mcp add --transport http since https://api.since.dev/mcp