Direct sign-in entry
Set a predictable landing page for users who open the sign-in route directly without a preserved destination.
Clerk · Pipe
signInFallbackRedirectUrl
Clerk’s signInFallbackRedirectUrl sets the post-sign-in destination when no redirect_url is already present. It defaults to / and is also used by sign-in links rendered from sign-up components.
How it works
This optional Clerk component prop supplies the destination after sign-in only when the current flow lacks a redirect_url. It defaults to /, and Clerk recommends configuring the corresponding environment variable instead when possible. The prop is also used for the sign-in link rendered by sign-up components.
Syntax
signInFallbackRedirectUrl?: stringParameters
| Name | Type | Description |
|---|---|---|
signInFallbackRedirectUrl | string | Optional fallback destination used after sign-in when no redirect_url exists; defaults to /. |
Key points
- It is a conditional destination: Clerk uses it after sign-in only when the path lacks redirect_url.
- In sign-up components, it supplies the destination for the link that sends an existing user to sign-in.
- The redirect URL settings are supported across multiple Clerk components, including ClerkProvider and SignUpButton.
- Clerk exposes redirect configuration through component props rather than requiring a single component integration.
Common mistakes
- An existing redirect_url takes precedence, so this fallback does not override an explicitly preserved destination.
- Prefer the platform-specific Clerk sign-in fallback environment variable for configuration when possible.
- Configure both sign-in and sign-up fallback destinations to handle users who switch flows.
Example: Configure a sign-in fallback on ClerkProvider
import { ClerkProvider } from '@clerk/nextjs';
export default function RootLayout({
children,
}: Readonly<{ children: React.ReactNode }>) {
return (
<ClerkProvider signInFallbackRedirectUrl="/dashboard">
{children}
</ClerkProvider>
);
}Sets /dashboard as the sign-in fallback when no redirect_url is already present.
When to use it
Sign-up-to-sign-in navigation
Send users who switch from a sign-up screen to sign-in to an appropriate application page.
Local component configuration
Provide component-level redirect configuration when an environment variable is not used.
Interview questions
QWhat does signInFallbackRedirectUrl do?
It is an optional URL prop that Clerk uses after sign-in when the path has no redirect_url. Its default destination is /, and an existing redirect_url takes precedence.
Follow-up: When would the prop have no effect? It has no effect when redirect_url is present, because the fallback is only consulted when that value is absent.
QHow is this prop used by sign-up components?
On sign-up components, it controls the destination for the rendered “Already have an account? Sign in” link. It is distinct from the general fallbackRedirectUrl used by sign-in and sign-up related components.
Follow-up: Why can this matter in a sign-up flow? A user who switches from sign-up to sign-in needs a sign-in-specific fallback destination, so the two settings can differ.
QWhat configuration practice does Clerk recommend?
The documentation recommends using the relevant environment variable instead of the prop whenever possible. It also recommends defining both sign-in and sign-up fallback variables because users can switch between those flows.
Follow-up: What should be checked before relying on the fallback? Verify that no redirect_url is already in the path, since that value takes precedence.
Related
fallbackRedirectUrlsignUpFallbackRedirectUrlCLERK_SIGN_IN_FALLBACK_REDIRECT_URLNEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URLNUXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URLredirect_url