Clerk · Pipe

signUpUrl

signUpUrl is an optional string containing the full URL or path to an application's sign-up page. Clerk uses it for the sign-up link rendered by <SignIn />; custom sign-up pages configure it to point to the route hosting <SignUp />.

How it works

signUpUrl is an optional string configuration value that identifies the full URL or path hosting the sign-up page. Clerk uses it for sign-up navigation and, when configured on a satellite application, it must point to the primary application’s client-side sign-up route.

Syntax

signUpUrl?: string

Parameters

Name	Type	Description
`signUpUrl`	`string`	Full URL or path to the sign-up page; used by Clerk for sign-up navigation.

Key points

The value can be either an absolute URL or a path to the page that hosts sign-up.
On the sign-in UI, Clerk uses the setting for the link that sends users to sign-up.
When building a custom sign-up page, configure the value to identify the route hosting <SignUp />.

Common mistakes

Prefer Clerk's environment variable configuration rather than hardcoding this prop when possible.

Example: Configure a custom sign-up route

import { ClerkProvider } from '@clerk/nextjs'

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <ClerkProvider signUpUrl="/sign-up">
      {children}
    </ClerkProvider>
  )
}

This configures Clerk to use the application's /sign-up route for sign-up navigation.

When to use it

Route sign-up navigation to an application page

A custom sign-up page is mounted at /sign-up.

Connect sign-in and sign-up flows

A sign-in screen needs a working account-creation link.

Direct satellite sign-up to the primary app

Authentication is split between a satellite domain and a primary application.

Interview questions

QWhat does signUpUrl configure?

signUpUrl is an optional string containing the full URL or path to the sign-up page. Clerk uses it to direct users to the configured sign-up route.

Follow-up: How should it be configured for a satellite app? It should point to the primary application's client-side sign-up route, and it is required in a development instance.

QHow do you configure a custom sign-up page?

Set signUpUrl on the relevant Clerk configuration, such as <ClerkProvider>, to the route where <SignUp /> is hosted. A relative path such as /sign-up is valid.

Follow-up: What alternative configuration does Clerk recommend? Use the corresponding environment variable instead of hardcoding the value.

QWhat are the satellite-application requirements?

For a satellite application, signUpUrl must point to the primary application on the client side. It is optional for production instances but required for development instances.

Follow-up: Why must it target the primary app? Sign-up flows for satellite domains are handled through the primary application's routes.

<SignUp />
<SignIn />
<ClerkProvider>
signInUrl
Clerk.buildSignUpUrl()

Source: <SignIn /> component - Authentication components - React. Checked 2026-10-15.