megachangelog
Clerk logo

Clerk Changelog

Clerk — Auth, Security product updates and releases, tracked on megachangelog.

SecurityAuthOfficial changelog ↗RSS
Improvement1.17.26

@clerk/vue 1.17.26

Updated @clerk/types dependency to version 4.101.28.

vuedependenciespatch
Improvement1.13.34

@clerk/nuxt@1.13.34

Updated internal dependencies for @clerk/types, @clerk/backend, and @clerk/vue to latest patch versions.

nuxtdependenciespatch
Improvement1.14.11

@clerk/testing dependencies updated

Updated @clerk/types to 4.101.28 and @clerk/backend to 2.33.8 to ensure compatibility and include latest improvements.

dependenciestestingpatch
Improvement2.4.18

Updated dependencies

Patch release updating internal Clerk dependencies including clerk-react, types, and backend packages to fix bugs and improve stability.

dependenciespatchreact-router
Improvement6.39.8

@clerk/nextjs@6.39.8

Patch release with updated dependencies including clerk-react, types, and backend packages.

nextjsclerk-reactbackenddependencies
Update4.13.51

@clerk/remix@4.13.51

Patch release with updated dependencies including clerk-react, types, and backend packages.

remixdependenciespatch
Improvement2.6.36

@clerk/fastify 2.6.36

Updated @clerk/types and @clerk/backend dependencies to include latest patches and fixes.

fastifydependenciesrelease
Improvement0.1.90

@clerk/hono@0.1.90

Updated @clerk/backend dependency to version 3.25.0. This patch release includes the latest backend improvements and bug fixes.

honodependenciesbackendpatch
Improvement7.9.17

@clerk/nextjs@7.9.17

Updated @clerk/backend dependency to version 3.25.0.

nextjsdependenciessdk
Improvement3.1.14

@clerk/nuxt 3.1.14

Updated @clerk/backend dependency to version 3.25.0.

nuxtdependenciesbackend
Improvement3.1.90

@clerk/fastify@3.1.90 - dependency update

Updated @clerk/backend dependency to version 3.25.0 to keep packages in sync with the latest improvements and fixes.

fastifydependenciesbackend
Improvement2.1.0

Add Expo SDK 58 support

Added support for Expo SDK 58 in the clerk/expo-passkeys package, enabling compatibility with the latest Expo runtime.

expopasskeyssdkcompatibility
Improvement2.2.47

@clerk/testing@2.2.47

Updated dependencies including @clerk/backend to version 3.25.0 to ensure compatibility with the latest backend features and improvements.

testingdependenciesbackend
Improvement2.1.80

@clerk/express updated with @clerk/backend@3.25.0

Updated @clerk/express to version 2.1.80 with a dependency update to @clerk/backend@3.25.0, which includes improvements and fixes from the backend package.

expressbackenddependenciesupdate
Improvement2.2.46

@clerk/testing@2.2.46

Updated dependencies, including @clerk/backend to version 3.24.0.

dependenciestestingbackendpatch
Improvement0.1.89

@clerk/hono@0.1.89

Patch release updating @clerk/backend dependency to version 3.24.0.

honodependenciesbackendpatch
Improvement3.6.34

@clerk/react-router v3.6.34

Updated @clerk/backend dependency to version 3.24.0. This patch release brings dependency updates to align with the latest backend improvements.

react-routerdependenciesbackend
Improvement7.9.16

@clerk/nextjs@7.9.16

Updated @clerk/backend dependency to version 3.24.0, bringing improvements and fixes from the backend package to the Next.js integration.

nextjsdependenciespatch
Improvement3.1.89

@clerk/fastify dependency update

Updated @clerk/backend dependency to version 3.24.0 as part of a patch release.

fastifydependenciesbackendpatch
Improvement2.1.79

@clerk/express dependency updates

Updated dependencies including @clerk/backend to version 3.24.0. This patch release includes dependency updates to ensure compatibility and incorporate improvements from upstream packages.

expressdependenciesbackend
Improvement3.1.13

@clerk/nuxt@3.1.13 patch release

Updated @clerk/backend dependency to version 3.24.0 with various improvements and fixes.

nuxtdependenciesbackendpatch
Improvement0.1.9

@clerk/mosaic 0.1.9 patch release

UserButton mode prop simplified to remove organization option; new OrganizationSwitcher export for organization-only switching. Label styling via CSS classes and UX improvements for active organization display and menu reorganization in UserButton and OrganizationSwitcher.

ui-componentsuserbuttonorganizationstyling
Breaking4.11.0

@clerk/expo-native-components package introduced

A new @clerk/expo-native-components package is now required for native components (AuthView, UserButton, UserProfileView). Install it before deploying over-the-air updates as errors occur at runtime; import native components from @clerk/expo/native-components and deprecate the old @clerk/expo/native import path.

exponative-componentsbreakingsdk
Breaking0.1.0

@clerk/expo-native-components 0.1.0

Introduces @clerk/expo-native-components, a new required package for native components (AuthView, UserButton, UserProfileView). Import native components from @clerk/expo/native-components instead of the deprecated @clerk/expo/native, and install the new package before shipping over-the-air updates to avoid runtime errors.

exponative-componentsmigrationiosandroid
Announcement7.9.15

@clerk/nextjs release

Version 7.9.15 of the Clerk Next.js SDK has been released with updates and improvements to the authentication library for Next.js applications.

nextjssdkauthclerk
Announcement3.1.94

@clerk/chrome-extension release

A new version of the Clerk Chrome extension package has been released with updates and improvements.

chrome-extensionsdkrelease
Announcement1.40.1

@clerk/ui@1.40.1

Release of @clerk/ui version 1.40.1 with updates and improvements to the UI component library.

uicomponentsrelease
Feature1.40.0

Role mapping step in self-serve Directory Sync setup

Organization admins can now assign organization roles to directory groups during self-serve Directory Sync setup in OrganizationProfile, with ability to configure role priority and toggle role syncing. Members with org:sys_memberships:manage permission can manage role mappings, while the step is read-only for others.

directory-syncorg-rolesuiidentity-provider
Improvement7.9.14

@clerk/nextjs dependency updates

Updated internal dependencies for @clerk/shared, @clerk/react, and @clerk/backend packages to latest patch and minor versions.

nextjsdependenciesmaintenance
Improvement3.6.33

@clerk/react-router@3.6.33

Patch release with updated dependencies for @clerk/shared, @clerk/react, and @clerk/backend.

react-routerdependenciespatch
Feature4.40.0

Add role mapping to Directory Sync setup and enterpriseConnectionsUrl option

Added a role mapping step to the self-serve Directory Sync setup in OrganizationProfile, allowing organization admins to assign roles to directory groups and control role syncing. Also added an enterpriseConnectionsUrl option to handleRedirectCallback and AuthenticateWithRedirectCallback for OAuth sign-up flows.

directory-syncrolesorganizationoauthauthentication
Improvement6.17.8

@clerk/react dependency update

Updated internal dependencies for @clerk/react to include the latest version of @clerk/shared (4.40.0). This patch ensures compatibility with the latest shared utilities.

reactdependenciespatch
Improvement0.1.8

@clerk/mosaic@0.1.8

Updated internal dependencies including @clerk/shared to version 4.40.0 with latest patches and improvements.

dependenciesmosaicmaintenance
Improvement2.5.12

@clerk/vue dependency updates

Updated internal dependencies including @clerk/shared to 4.40.0 to incorporate latest shared library improvements and fixes.

vuedependenciespatch
Improvement3.1.12

@clerk/nuxt v3.1.12

Patch release that updates internal dependencies for @clerk/shared, @clerk/backend, and @clerk/vue to their latest versions.

nuxtdependenciespatch
Improvement2.2.45

@clerk/testing 2.2.45

Updated dependencies including @clerk/shared@4.40.0 and @clerk/backend@3.23.2 to incorporate latest shared utilities and backend enhancements.

testingdependenciespatch
Improvement1.7.1

@clerk/tanstack-react-start@1.7.1

Patch release with updated dependencies for @clerk/shared, @clerk/react, and @clerk/backend.

clerktanstack-react-startdependenciespatch
Fix7.9.13

Export HandleSSOCallback component from @clerk/nextjs

The HandleSSOCallback component is now exported from @clerk/nextjs, enabling its use on SSO callback routes in custom authentication flows. Previously the import would fail.

nextjsssoauthexports
Feature4.10.0

Add revokeCurrentDeviceCredential() to useBiometricCredentials()

A new revokeCurrentDeviceCredential() method has been added to useBiometricCredentials() for Expo, allowing you to revoke the device's biometric credential without storing the credential ID from enroll(). Call it before signing out since it requires an active session.

expobiometricsauthcredentials
Improvement3.1.11

@clerk/nuxt@3.1.11

Patch release updating internal dependencies for @clerk/shared, @clerk/backend, and @clerk/vue to their latest versions.

nuxtdependenciespatch
Improvement1.39.1

@clerk/ui dependency updates

Updated @clerk/shared and @clerk/localizations dependencies to their latest patch versions.

dependenciesuilocalization
Improvement7.9.12

@clerk/nextjs 7.9.12

Patch release updating internal dependencies including @clerk/react, @clerk/shared, and @clerk/backend to their latest versions.

nextjsdependenciespatch
Improvement3.6.32

@clerk/react-router@3.6.32

Updated dependencies including @clerk/react@6.17.7, @clerk/shared@4.39.1, and @clerk/backend@3.23.1 to incorporate the latest patches and improvements.

react-routerdependenciespatchsdk
Improvement4.39.1

Improved error messages for missing/invalid keys

Updated error messages to clarify that npx clerk@latest init does not require a Clerk account and generates temporary dev keys automatically. This reduces confusion for users who mistakenly believed they needed to sign up before running initialization.

clerkinitializationerror-messagesdeveloper-experience
Breaking1.7.0

Raise minimum @tanstack/react-start and @tanstack/react-router peer dependencies

Minimum supported versions for @tanstack/react-start and @tanstack/react-router have been raised to enable reliable CSRF middleware import during Vite SSR. The change requires registering createCsrfMiddleware() before clerkMiddleware() when using src/start.ts.

tanstackclerkdependenciescsrfbreaking
Fix6.17.7

Fix HandleSSOCallback dropping error when Clerk Protect challenge fails

Fixed a bug where HandleSSOCallback was dropping errors when a Clerk Protect challenge failed during SSO callback. Errors are now properly available through useSignIn() and useSignUp(), and failed sign-up challenges correctly navigate to the sign-up page.

reactssoauthbug-fixsecurity
Improvement2.2.44

@clerk/testing dependency updates

Updated dependencies including @clerk/shared and @clerk/backend to latest patch versions. This ensures compatibility with the latest shared utilities and backend functionality.

dependenciestestingpatchmaintenance
Breaking0.1.7

Rename userButton.workspaces to userButton.organizations

The userButton.workspaces localization keys have been renamed to userButton.organizations. Users must update any overrides of userButton.workspaces.* to use userButton.organizations.* instead.

localizationbreakinguiuserbutton
Improvement7.9.11

Remove Clerk-internal host from default CSP directive

Removed https://images.clerkstage.dev from the default connect-src Content Security Policy directive as it is an internal Clerk storage host not used by applications. Organization logos continue to be served from https://img.clerk.com.

securitycspnextjspatch
Improvement3.6.31

@clerk/react-router@3.6.31

Updated dependencies on @clerk/backend, @clerk/shared, and @clerk/react to incorporate recent improvements and fixes.

dependenciesreact-routerclerk
Improvement3.1.10

@clerk/nuxt@3.1.10

Patch release updating dependencies to @clerk/backend@3.23.0, @clerk/shared@4.39.0, and @clerk/vue@2.5.10 to include the latest bug fixes and improvements.

nuxtdependenciespatch
Improvement6.17.6

@clerk/react 6.17.6

Updated @clerk/shared dependency to version 4.39.0 with improvements and fixes.

reactdependenciesclerk
Improvement0.1.6

Update UserButton to latest designs with improved account handling

UserButton component has been redesigned with combined mode now leading with the account and the modePriority prop removed. Settings now opens organization and profile settings, while Sign out of all accounts has been moved into the Switch account menu.

userbuttonuicomponentsdesign
Feature4.39.0

Support multiple IdP signing certificates for SAML enterprise connections

SAML enterprise connections can now trust multiple Identity Provider signing certificates with their validity windows. The EnterpriseConnection.samlConnection includes idpCertificates, and creation/update methods accept an array of certificates instead of a single certificate.

samlenterpriseauthapi
Improvement2.5.10

@clerk/vue@2.5.10 patch release

Updated @clerk/shared dependency to version 4.39.0 to bring in the latest shared utilities and fixes.

vuedependenciespatch
Feature1.39.0

Self-serve SSO certificate management with IdP key rotation support

The OrganizationProfile SSO configuration now displays all SAML signing certificates with expiry dates, allowing admins to add or remove certificates from files without requiring IdP synchronization. Up to five certificates are supported per connection.

ssosamlsecurityadminui
Improvement1.6.5

@clerk/tanstack-react-start@1.6.5

Patch release that updates internal dependencies including @clerk/backend, @clerk/shared, and @clerk/react to their latest versions for improved stability and compatibility.

tanstackreactdependenciespatch
Improvement2.2.43

@clerk/testing 2.2.43

Patch release with updated dependencies including @clerk/backend 3.23.0 and @clerk/shared 4.39.0.

testingdependenciespatch
Announcement7.9.10

@clerk/nextjs 7.9.10 Release

Released version 7.9.10 of the @clerk/nextjs package with bug fixes and improvements for Next.js integration.

nextjssdkclerkauth
Announcement2.2.42

@clerk/testing release 2.2.42

Release of @clerk/testing version 2.2.42 with updates and improvements to the testing library for Clerk authentication.

testingclerkrelease
Announcement4.38.0

@clerk/shared 4.38.0

Release of @clerk/shared package version 4.38.0 with updates and improvements.

sharedreleasesdk
Update6.17.5

@clerk/react@6.17.5

A patch release of the Clerk React library.

reactsdkjavascript
Update3.1.9

Clerk Nuxt 3.1.9

Patch release for the Clerk Nuxt SDK.

nuxtsdkclerk
Announcement3.6.30

@clerk/react-router 3.6.30

Release of @clerk/react-router version 3.6.30 with updates and improvements to the React Router integration library.

react-routerauthenticationsdkjavascript
Announcement2.5.9

@clerk/vue release 2.5.9

New patch release of the Clerk Vue integration library.

vuesdkrelease
Announcement1.38.1

@clerk/ui@1.38.1

Release of the Clerk UI library version 1.38.1 with updates and improvements to the UI component package.

uicomponentsrelease
Announcement0.1.5

@clerk/mosaic@0.1.5

Release of @clerk/mosaic version 0.1.5 with component library updates and improvements.

mosaiccomponent-libraryrelease
Improvement0.1.4

@clerk/mosaic 0.1.4 patch

Menu.Popup now retains its contents during close animations, and focus rings on menu items are hidden when the menu is hovered with the mouse, appearing only during keyboard navigation. Dependencies updated including @clerk/shared@4.37.1.

ui-componentsmenuaccessibilityinteractions
Improvement3.1.8

@clerk/nuxt 3.1.8

Patch release with updated dependencies for @clerk/backend, @clerk/shared, and @clerk/vue to resolve compatibility issues and improvements.

nuxtdependenciesrelease
Fix7.9.9

Removed trailing period from error message

Fixed an issue where error messages displayed with a trailing period, causing agents to encounter 404 errors when attempting to use the URL directly.

nextjserror-handlingfix
Improvement2.5.8

@clerk/vue v2.5.8

Updated dependencies including @clerk/shared to version 4.37.1. This patch release ensures compatibility with the latest shared utilities.

vuedependenciespatch
Improvement2.2.41

@clerk/testing@2.2.41

Patch update with updated dependencies for @clerk/backend and @clerk/shared to ensure compatibility and stability.

testingdependenciespatch
Improvement3.6.29

@clerk/react-router@3.6.29

Patch release updating dependencies including clerk/backend, clerk/shared, and clerk/react to their latest versions.

react-routerdependenciespatch
Improvement1.6.3

@clerk/tanstack-react-start patch update

Patch release with updated dependencies for @clerk/backend, @clerk/shared, and @clerk/react to address internal improvements and fixes across the Clerk ecosystem.

clerktanstackreactdependencies
Improvement6.17.4

useSignIn() and useSignUp() now handle Clerk Protect challenges

Custom flows using useSignIn() and useSignUp() now automatically handle Clerk Protect challenges by displaying them in a modal and returning once the user passes verification. For SSO flows, challenges appear when the user returns to HandleSSOCallback. Classic resource methods and apps without Clerk UI continue to return with protectCheck as before.

authreactprotectionssosignin
Improvement4.37.1

Custom flows with useSignIn/useSignUp now handle Clerk Protect challenges

useSignIn() and useSignUp() custom flows now automatically handle Clerk Protect challenges by displaying them in a modal and returning once the user completes the challenge. SSO challenges appear at HandleSSOCallback, while classic resource methods continue returning protectCheck as before.

authsecurityhooksssoclerk-protect
Announcement6.17.3

@clerk/react@6.17.3

Release of @clerk/react version 6.17.3.

clerkreactrelease
Announcement2.2.40

@clerk/testing@2.2.40

Release of the Clerk testing library version 2.2.40 with updates to testing utilities and fixtures.

testinglibraryrelease
Announcement1.37.0

@clerk/ui@1.37.0

Release of the Clerk UI package version 1.37.0 with unspecified updates.

uiclerk-uirelease
Announcement1.6.2

Clerk TanStack React Start

Release of version 1.6.2 of the Clerk TanStack React Start integration package.

clerktanstackreact-startrelease
Announcement2.5.7

@clerk/vue@2.5.7

Release of Clerk Vue SDK version 2.5.7 with updates and improvements.

vuesdkrelease
Announcement4.37.0

@clerk/shared v4.37.0

Release of @clerk/shared v4.37.0 containing updates and improvements to the shared utilities library.

libraryutilitiessdkrelease
Update3.6.28

@clerk/react-router v3.6.28

Release of @clerk/react-router version 3.6.28 with improvements and fixes for React Router integration.

react-routerclerkrelease
Announcement0.1.3

@clerk/mosaic@0.1.3

Release of @clerk/mosaic version 0.1.3 with updates to the design system package.

mosaicdesign-systemrelease
Announcement3.1.7

@clerk/nuxt@3.1.7 Release

Clerk Nuxt SDK version 3.1.7 released. This version includes bug fixes and improvements to the Nuxt integration for Clerk authentication.

nuxtsdkauthrelease
Update7.9.8

@clerk/nextjs@7.9.8

Release of @clerk/nextjs version 7.9.8 containing updates and improvements for the Clerk Next.js SDK.

nextjssdkclerk
Improvement0.1.2

@clerk/mosaic 0.1.2

Updated dependencies including @clerk/shared to version 4.36.0.

mosaicdependenciespatch
Improvement7.9.7

@clerk/nextjs@7.9.7

Patch release with updated dependencies including @clerk/shared, @clerk/react, and @clerk/backend to their latest versions.

nextjspatchdependenciesclerk
Improvement4.36.0

@clerk/shared@4.36.0

Added a dedicated blocked request screen in SignIn/SignUp components with support reference details. Fixed enterprise SSO sign-ins that were failing with verification challenges, and improved error handling to expose traceId and metadata in action_blocked errors.

authssocomponentserror-handling

Sign up to see more

97 more changes from Clerk. Sign up to read the whole changelog.

Sign up free

GitHub or email — no card needed.