megachangelog
Clerk logo

Clerk Changelog

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


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
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
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
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
Update6.17.5

@clerk/react@6.17.5

A patch release of the Clerk React library.

reactsdkjavascript
Announcement4.38.0

@clerk/shared 4.38.0

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

sharedreleasesdk
Announcement0.1.5

@clerk/mosaic@0.1.5

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

mosaiccomponent-libraryrelease
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
Announcement2.5.9

@clerk/vue release 2.5.9

New patch release of the Clerk Vue integration library.

vuesdkrelease
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
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
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
Update3.1.9

Clerk Nuxt 3.1.9

Patch release for the Clerk Nuxt SDK.

nuxtsdkclerk
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
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
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
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
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
Announcement1.37.0

@clerk/ui@1.37.0

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

uiclerk-uirelease
Announcement2.5.7

@clerk/vue@2.5.7

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

vuesdkrelease
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.6.2

Clerk TanStack React Start

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

clerktanstackreact-startrelease
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
Announcement6.17.3

@clerk/react@6.17.3

Release of @clerk/react version 6.17.3.

clerkreactrelease
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
Update3.1.6

@clerk/nuxt 3.1.6

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

nuxtdependenciespatch
Improvement3.6.27

@clerk/react-router@3.6.27

Patch update with dependency updates to @clerk/shared, @clerk/react, and @clerk/backend.

clerkreact-routerdependencies
Improvement1.36.0

@clerk/ui@1.36.0

Added a dedicated blocked request screen in SignIn and SignUp components with error reference information, and fixed enterprise SSO sign-ins to properly show verification challenges instead of erroring. Improved error handling for protect_check_required scenarios and fixed issues with verification challenge cards spinning indefinitely and sign-ins stranding on "Use another method".

uiauthenticationsign-inverificationenterprise-sso
Improvement1.6.1

@clerk/tanstack-react-start@1.6.1

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

clerkreacttanstackdependencies
Improvement2.2.39

@clerk/testing 2.2.39

Updated internal dependencies for @clerk/shared and @clerk/backend to latest versions.

testingdependenciesmaintenance
Improvement6.17.2

@clerk/react dependency update

Updated internal dependencies to the latest versions including @clerk/shared@4.36.0.

reactdependenciespatch
Improvement2.5.6

@clerk/vue 2.5.6

Patch release updating internal dependencies, including @clerk/shared to version 4.36.0.

vuedependenciespatch
Announcement0.1.1

@clerk/mosaic release

Release of @clerk/mosaic version 0.1.1. Check the release notes for details on what's included in this update.

mosaicreleaseclerk
Announcement7.9.6

@clerk/nextjs 7.9.6

Maintenance release for the Clerk Next.js SDK.

nextjssdkclerk
Announcement3.1.5

@clerk/nuxt 3.1.5

Release of Clerk Nuxt integration version 3.1.5 with updates to the authentication SDK for Nuxt applications.

nuxtsdkauthenticationrelease
Announcement6.17.1

@clerk/react version 6.17.1

Release of @clerk/react 6.17.1 with updates to the React authentication library.

reactsdkauth
Announcement3.6.26

@clerk/react-router@3.6.26

Release of @clerk/react-router version 3.6.26 with updates to the React Router integration for Clerk authentication.

react-routersdkauthentication
Announcement4.35.0

@clerk/shared@4.35.0

Release of the Clerk shared utilities package version 4.35.0 with updates to shared components and functionality.

clerksharedpackagerelease
Announcement1.35.0

@clerk/ui@1.35.0

Release of @clerk/ui version 1.35.0 with updates to the UI component library.

uicomponentsrelease
Announcement2.5.5

Clerk Vue 2.5.5

Version release of the Clerk Vue library with updates and improvements to the Vue integration for Clerk authentication.

vuesdkrelease
Announcement1.6.0

@clerk/tanstack-react-start 1.6.0

Release of version 1.6.0 for the Clerk TanStack React Start integration package, providing updates and improvements to the React authentication library.

clerkreactauthtanstack
Announcement2.2.38

@clerk/testing version 2.2.38

Release of @clerk/testing package version 2.2.38 with updates and improvements to the testing library.

testingsdkrelease
Improvement2.5.4

@clerk/vue 2.5.4

Patch release updating dependencies including @clerk/shared to 4.34.0.

vuedependenciespatch
Improvement2.2.37

@clerk/testing dependency updates

Updated @clerk/testing dependencies including @clerk/shared to 4.34.0 and @clerk/backend to 3.19.0 to bring in latest patches and improvements.

testingdependenciespatch
Improvement6.17.0

Rename SSO fallback flow to SSO bypass in React SDK

The SSO fallback sign-in flow has been renamed to SSO bypass to align with the feature's official name. This affects the ssoFallbackFirstFactors property, localization keys, and card action element IDs, but no applications are impacted since the feature hasn't been enabled on any instance yet.

reactssoauthenticationapi
Improvement3.6.25

@clerk/react-router@3.6.25

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

react-routerdependenciespatch
Security7.9.5

@clerk/nextjs 7.9.5 patch release

Fixed a React key warning in ClerkProvider with App Router and resolved a cross-request credential leak in clerkMiddleware when using dynamic secret keys. Each request now has its own isolated store to prevent secret key visibility across concurrent requests.

nextjsreactmiddlewaresecurityauth
Improvement1.5.16

@clerk/tanstack-react-start 1.5.16 patch release

Updated dependencies including @clerk/shared, @clerk/react, and @clerk/backend to latest versions with bug fixes and improvements.

clerktanstack-react-startdependenciespatch
Improvement3.1.4

@clerk/nuxt@3.1.4 patch release

Updated dependencies including @clerk/shared to 4.34.0, @clerk/backend to 3.19.0, and @clerk/vue to 2.5.4. This patch release maintains compatibility with the latest Clerk packages.

nuxtdependenciespatch
Feature4.34.0

Add phone metadata and SSO bypass management features in @clerk/shared

@clerk/shared@4.34.0 adds phone-number parsing and formatting helpers, renames SSO fallback terminology to SSO bypass throughout the library, and enables organization admins to manage SSO bypass allowlist from OrganizationProfile. New utilities for URL parameter resolution and enterprise connection management UI improvements are also included.

sharedssophoneorganizationapi
Feature1.34.0

@clerk/ui@1.34.0

This release renames the SSO fallback feature to SSO bypass and adds tools for Organization admins to manage the SSO bypass allowlist from OrganizationProfile. It also includes UI improvements for enterprise connection management, new phone utilities in @clerk/shared, and several fixes for OAuth flows and account reconnection.

uissoorganizationoauthphone
Improvement1.17.25

@clerk/vue dependency updates

Updated @clerk/shared to 3.48.0 and @clerk/types to 4.101.27 to keep the Vue library in sync with the latest Clerk dependencies.

vuedependenciespatch
Improvement6.39.7

@clerk/nextjs v6.39.7 – Dependency updates

Updated internal dependencies including @clerk/shared, @clerk/backend, @clerk/clerk-react, and @clerk/types to their latest patch versions.

nextjsdependenciespatch

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.