Build your own sign-up page for your Next.js app with Clerk
By default, the <SignIn /> component handles signing in and signing up, but if you'd like to have a dedicated sign-up page, this guide shows you how to use the <SignUp /> component to build a custom sign-up page.
To set up a single sign-in-or-up page, follow the custom sign-in-or-up page guide.
Build a sign-up page
The following example demonstrates how to render the <SignUp /> component on a dedicated sign-up page using the Next.js optional catch-all route.
import { SignUp } from '@clerk/nextjs'
export default function Page() {
return <SignUp />
}Make the sign-up route public
By default, clerkMiddleware() makes all routes public. This step is specifically for applications that have configured clerkMiddleware() to make all routes protectedclerkMiddleware() to protect all routes, you can skip this step.
To make the sign-up route public:
- Navigate to your
proxy.tsfile. - Add the sign-up route to your existing route matcher that is making routes public.
import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server'
const isPublicRoute = createRouteMatcher([
'/sign-in(.*)',
'/sign-up(.*)'
])
export default clerkMiddleware(async (auth, req) => {
if (!isPublicRoute(req)) {
await auth.protect()
}
})
export const config = {
matcher: [
// Skip Next.js internals and all static files, unless found in search params
'/((?!_next|[^?]*\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)',
// Always run for API routes
'/(api|trpc)(.*)',
],
}Update your environment variables
- Set the
CLERK_SIGN_UP_URLenvironment variable to tell Clerk where the<SignUp />component is being hosted. - Set
CLERK_SIGN_UP_FALLBACK_REDIRECT_URLas a fallback URL incase users visit the/sign-uproute directly. - Set
CLERK_SIGN_IN_FALLBACK_REDIRECT_URLas a fallback URL incase users select the 'Already have an account? Sign in' link at the bottom of the component.
Learn more about these environment variables and how to customize Clerk's redirect behavior in the dedicated guide.
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/Visit your new page
Run your project with the following command:
npm run devpnpm run devyarn devbun run devVisit your new custom page locally at localhost:3000/sign-up.
Next steps
Learn more about Clerk components, how to customize them, and how to use Clerk's client-side helpers using the following guides.
Protect content and read user data
Learn how to use Clerk's hooks and helpers to protect content and read user data in your Next.js app.
Client-side helpers
Learn more about Clerk's client-side helpers and how to use them.
Prebuilt components
Learn how to quickly add authentication to your app using Clerk's suite of components.
Customization & localization
Learn how to customize and localize Clerk components.
Clerk Next.js SDK Reference
Learn about the Clerk Next.js SDK and how to integrate it into your app.
Feedback
Last updated on