Clerk Changelog

Launching a new product but not ready to open it up to everyone yet? Waitlist Sign-up mode is here to help you manage early access seamlessly.

What's New?

With Waitlist Sign-up mode, you have complete control over onboarding new users:

• Your <Waitlist /> component collects prospective users’ email addresses.
• These users are added to a Waitlist queue in your Clerk Dashboard⁠.
• You decide which entries get accepted or rejected. Or simply invite new users directly.
• Once your product is ready for the world, just switch your Sign-up mode to public and you're live 🚀.

Give it a try

• Visit your Clerk Dashboard⁠.
• Learn more about the Waitlist Sign-Up Mode.

Keep your application compliant by requiring legal consent on your application's <SignUp /> views.

If you are using Clerk’s pre-built component or the Account Portal, simply enable it from the Clerk Dashboard⁠. Your users will be required to accept your legal documents before they are allowed to create an account, and you will have one less compliance issue to worry about.

Ready to dive in?

Head to your Clerk Dashboard⁠, or check out the documentation to get started.

Previously, your user exports weren't as accessible as we would have liked. Customers had to export via our Backend API or if you needed hashed passwords, you had to rely on our support team to trigger a user export.

Now you can easily generate and download a CSV export of your users, all within the Clerk Dashboard⁠.

Key Features:

• Settings Page: This new feature is added to the dashboard Settings.
• Export and Download Logs: The Settings page also includes a table displaying logs for both export requests and downloads, providing a complete history of export activities.
• Real-time export management: Trigger user exports with the new "Export All Users" button. Track progress in real-time with status updates displayed on the Exports logs table on the Settings page, including when the file is ready for download.
• Automatic notifications: Once the export completes, you’ll receive a toast notification and can download the CSV file directly from the dashboard.
• Flexible navigation: You can navigate away or switch tabs without interrupting the export process, and you’ll still get notified when the export is done.

Other Details:

• The download button remains visible until the file expires, allowing you to download the list at any time before requesting a new one.
• The export is restricted to admins (or users in their personal workspace), ensuring the feature is secure and accessible only to authorized users.

The Next.js team has announced the stable release of Next.js 15⁠, and Clerk is continuing the tradition of (nearly) same-day support for new major Next.js releases with the release of @clerk/nextjs v6.

Get started by running the Clerk upgrade CLI:

npx @clerk/upgrade

Not ready to upgrade to Next.js v15? No problem: @clerk/nextjs v6 is backwards compatible with Next.js v14, including the switch to static rendering by default.

Asynchronous auth() (breaking change)

Now that Next.js's request APIs are asynchronous⁠, Clerk's auth() helper will follow suit. In addition to supporting Next.js's new async APIs, this change will also allow the addition of more robust validations and new functionality into the auth() helper. Stay tuned!

import { auth } from '@clerk/nextjs/server'

export default async function Page() {
  const { userId } = await auth()

  if (!userId) {
    return <h1>Hello, guest!</h1>
  }

  return <h1>Hello, {userId}!</h1>
}

With the change to async, we weren't happy with how the usage of auth().protect() felt, so we moved protect to be a property of auth, instead of part of the return value.

import { auth } from '@clerk/nextjs/server'

export default async function Page() {
  const { userId } = await auth.protect()

  return <h1>Hello, {userId}!</h1>
}

To make migration as easy as possible, we're also including a codemod that will update your usages of auth() and auth().protect(). For situations where the codemod isn't able to update your code, please see the upgrade guide for detailed steps.

Static rendering by default, opt-in dynamic (and partial prerendering support)

Historically, usage of <ClerkProvider> has opted your entire application in to dynamic rendering due to the dynamic and personalized nature of auth-related data. We've heard the feedback from our users that this default didn't feel like it aligned with Next.js best practices. Starting with v6, <ClerkProvider> will no longer opt your entire application into dynamic rendering by default. This change also brings support for Next.js's upcoming Partial Prerendering mode (PPR)⁠. PPR allows a page to be both static and dynamic by moving the optimization from pages to components.

Dynamic auth data is still available by using the auth() helper in a server component. This data can also be passed to client components directly as needed. This is the recommended way to access auth data going forward. For existing applications that use the useAuth() hook in Client Components that are server-side rendered, this is a breaking change. Wrap these components in <ClerkProvider dynamic> to make auth data available to the hook during rendering. As a best practice, we recommend wrapping usage of <ClerkProvider dynamic> with suspense to ensure your page is setup to take advantage of PPR.

import { Suspense } from 'react'
import { ClerkProvider } from '@clerk/nextjs'

export default function Page() {
  return (
    <main>
      <header>
        <Logo />
        <Suspense fallback={<FallbackAvatar />}>
          <ClerkProvider dynamic>
            <UserAvatar />
          </ClerkProvider>
        </Suspense>
      </header>
    </main>
  )
}

If you want <ClerkProvider> to continue making dynamic auth data available by default, add the dynamic prop to your root <ClerkProvider>:

import { ClerkProvider } from '@clerk/nextjs'

export default function RootLayout({ children }) {
  return (
    <ClerkProvider dynamic>
      <html>
        <body>{children}</body>
      </html>
    </ClerkProvider>
  )
}

This opts every single page into dynamic rendering, or PPR when enabled. For this reason, it is still recommended to take a more granular approach to dynamic data access by using <ClerkProvider dynamic> further down your component tree.

To learn more about Next.js's different rendering modes and how Clerk interacts with them, check out the documentation.

Removal of deprecated APIs

A number of deprecated APIs have been removed as part of this release:

• authMiddleware() - use clerkMiddleware() instead
• redirectToSignIn() - use const { redirectToSignIn } = await auth() instead
• redirectToSignUp() - use const { redirectToSignUp } = await auth() instead
• clerkClient singleton - use await clerkClient() instead

For more information, please see the upgrade guide.

Fastify, the fast and low overhead web framework for Node.js, has recently shipped Fastify v5. In order to support Fastify v5 a new major version of @clerk/fastify had to be released. With Clerk's Fastify SDK 2.0 comes full support for Fastify v5 and no breaking changes for the Clerk SDK itself.

If you're using Fastify and @clerk/fastify, you can update like so:

1. Follow the official Fastify v5 migration guide⁠
2. Install the latest version of @clerk/fastify

   npm install @clerk/fastify@latest

3. You're done! No further changes needed

@clerk/fastify@^2.0.0 only supports Fastify v5 or later, if you want/need to continue using Fastify v4, please stick with @clerk/fastify@^1.0.0.

We're excited to announce the release of @clerk/express, our latest SDK designed specifically for Express applications⁠.

The SDK comes fully equipped with server utilities and low level utilities for any of your custom flows.

Here's an example on how simple it is to protect a route with our Express SDK:

import express from 'express'
import { requireAuth } from '@clerk/express'

const app = express()

// if the user is not signed in, they will be redirected to /sign-in automatically
app.get('/protected', requireAuth({ signInUrl: '/sign-in' }), (req, res) => {
  return res.json({ userId: req.auth.userId })
})

Deprecating @clerk/clerk-sdk-node

With this release, we are initiating the process to deprecate @clerk/clerk-sdk-node.

During this transition period, we intend to:

• Continue to provide critical patches and bug fixes for @clerk/clerk-sdk-node
• Pause adding new features to @clerk/clerk-sdk-node
• Focus our development efforts on @clerk/express

The transition to end @clerk/clerk-sdk-node support ends on January 8, 2025. To ensure a smooth transition, we've prepared a comprehensive Migration Guide with step-by-step instructions.

Upgrade today and experience enhanced authentication and user management in your Express projects with Clerk!