<SignUp />
component
The <SignUp />
component renders a UI for signing up users. The functionality of the <SignUp />
component is controlled by the instance settings you specify in your Clerk Dashboard, such as sign-in and sign-up options and social connections. You can further customize your <SignUp />
component by passing additional properties at the time of rendering.
Properties
All props are optional.
- Name
appearance
- Type
Appearance | undefined
- Description
Optional object to style your components. Will only affect Clerk Components and not Account Portal pages.
- Name
routing
- Type
'hash' | 'path' | 'virtual'
- Description
The routing strategy for your pages.
Defaults to'path'
in Next.js and Remix applications. Defaults tohash
for all other SDK's.
- Name
path
- Type
string
- Description
The path where the component is mounted on when
routing
is set topath
. It is ignored in hash- and virtual-based routing.
For example:/sign-up
.
- Name
signInUrl
- Type
string
- Description
Full URL or path to the sign in page. Use this property to provide the target of the 'Sign In' link that's rendered. It's recommended to use the environment variable instead.
- Name
forceRedirectUrl?
- Type
string
- Description
If provided, this URL will always be redirected to after the user signs up. Takes priority over deprecated props such as
afterSignUpUrl
andredirectUrl
. It's recommended to use the environment variable instead.
- Name
fallbackRedirectUrl?
- Type
string
- Description
The fallback URL to redirect to after the user signs up, if there's no
redirect_url
in the path already. Defaults to/
. Takes priority over deprecated props such asafterSignUpUrl
andredirectUrl
. It's recommended to use the environment variable instead.
- Name
signInForceRedirectUrl?
- Type
string
- Description
If provided, this URL will always be redirected to after the user signs in. Takes priority over deprecated props such as
afterSignUpUrl
andredirectUrl
. It's recommended to use the environment variable instead.
- Name
signInFallbackRedirectUrl?
- Type
string
- Description
The fallback URL to redirect to after the user signs in, if there's no
redirect_url
in the path already. Defaults to/
. Takes priority over deprecated props such asafterSignUpUrl
andredirectUrl
. It's recommended to use the environment variable instead.
- Name
initialValues
- Type
SignUpInitialValues
- Description
The values used to prefill the sign-up fields with.
Usage with frameworks
The following example includes basic implementation of the <SignUp />
component. You can use this as a starting point for your own implementation.
The following example demonstrates how you can use the <SignUp />
component on a public page.
If you would like to create a dedicated /sign-up
page in your Next.js application, check out the dedicated guide..
import { SignUp, useUser } from "@clerk/nextjs";
export default function Home() {
const { user } = useUser();
if (!user) {
return <SignUp />;
}
return <div>Welcome!</div>;
}
import { SignUp } from "@clerk/clerk-react";
const SignUpPage = () => (
<SignUp path="/sign-up" />
);
export default SignUpPage;
import { SignUp } from "@clerk/remix";
export default function SignUpPage() {
return (
<div style={{ border: "2px solid blue", padding: "2rem" }}>
<h1>Sign Up route</h1>
<SignUp />
</div>
);
}
import { SignUp } from "gatsby-plugin-clerk";
export default function SignUpPage() {
return (
<div style={{ border: "2px solid blue", padding: "2rem" }}>
<h1>Sign Up route</h1>
<SignUp path="/sign-up" />
</div>
);
}
Usage with JavaScript
The following methods available on an instance of the Clerk
class are used to render and control the <SignUp />
component:
The following examples assume that you have followed the quickstart in order to add Clerk to your JavaScript application.
mountSignUp()
Render the <SignUp />
component to an HTML <div>
element.
function mountSignUp(node: HTMLDivElement, props?: SignUpProps): void;
- Name
node
- Type
HTMLDivElement
- Description
The
<div>
element used to render in the<SignUp />
component
- Name
props?
- Type
SignUpProps
- Description
The properties to pass to the
<SignUp />
component.
import { Clerk } from '@clerk/clerk-js';
// Initialize Clerk with your Clerk publishable key
const clerk = new Clerk('YOUR_PUBLISHABLE_KEY');
await clerk.load();
document.getElementById("app").innerHTML = `
<div id="sign-up"></div>
`;
const signUpDiv =
document.getElementById("sign-up");
clerk.mountSignUp(signUpDiv);
<!-- Add a <div id="sign-up"> element to your HTML -->
<div id="sign-up"></div>
<!-- Initialize Clerk with your
Clerk Publishable key and Frontend API URL -->
<script
async
crossorigin="anonymous"
data-clerk-publishable-key="YOUR_PUBLISHABLE_KEY"
src="https://YOUR_FRONTEND_API_URL/npm/@clerk/clerk-js@latest/dist/clerk.browser.js"
type="text/javascript"
></script>
<script>
window.addEventListener("load", async function () {
await Clerk.load();
const signUpDiv =
document.getElementById('sign-up');
Clerk.mountSignUp(signUpDiv);
});
</script>
unmountSignUp()
Unmount and run cleanup on an existing <SignUp />
component instance.
function unmountSignUp(node: HTMLDivElement): void;
- Name
node
- Type
HTMLDivElement
- Description
The container
<div>
element with a rendered<SignUp />
component instance
import { Clerk } from '@clerk/clerk-js';
// Initialize Clerk with your Clerk publishable key
const clerk = new Clerk('YOUR_PUBLISHABLE_KEY');
await clerk.load();
document.getElementById("app").innerHTML = `
<div id="sign-up"></div>
`;
const signUpDiv =
document.getElementById("sign-up");
clerk.mountSignUp(signUpDiv);
// ...
clerk.unmountSignUp(signUpDiv);
<!-- Add a <div id="sign-up"> element to your HTML -->
<div id="sign-up"></div>
<!-- Initialize Clerk with your
Clerk Publishable key and Frontend API URL -->
<script
async
crossorigin="anonymous"
data-clerk-publishable-key="YOUR_PUBLISHABLE_KEY"
src="https://YOUR_FRONTEND_API_URL/npm/@clerk/clerk-js@latest/dist/clerk.browser.js"
type="text/javascript"
></script>
<script>
window.addEventListener("load", async function () {
await Clerk.load();
const signUpDiv =
document.getElementById('sign-up');
Clerk.mountSignUp(signUpDiv);
// ...
Clerk.unmountSignUp(signUpDiv);
});
</script>
openSignUp()
Opens the <SignUp />
component as an overlay at the root of your HTML body
element.
function openSignUp(props?: SignUpProps): void;
- Name
props?
- Type
SignUpProps
- Description
The properties to pass to the
<SignUp />
component
import { Clerk } from '@clerk/clerk-js';
// Initialize Clerk with your Clerk publishable key
const clerk = new Clerk('YOUR_PUBLISHABLE_KEY');
await clerk.load();
clerk.openSignUp();
<!-- Initialize Clerk with your
Clerk Publishable key and Frontend API URL -->
<script
async
crossorigin="anonymous"
data-clerk-publishable-key="YOUR_PUBLISHABLE_KEY"
src="https://YOUR_FRONTEND_API_URL/npm/@clerk/clerk-js@latest/dist/clerk.browser.js"
type="text/javascript"
></script>
<script>
window.addEventListener("load", async function () {
await Clerk.load();
Clerk.openSignUp();
});
</script>
closeSignUp()
Closes the sign up overlay.
function closeSignUp(): void;
import { Clerk } from '@clerk/clerk-js';
// Initialize Clerk with your Clerk publishable key
const clerk = new Clerk('YOUR_PUBLISHABLE_KEY');
await clerk.load();
clerk.openSignUp();
// ...
clerk.closeSignUp();
<!-- Initialize Clerk with your
Clerk Publishable key and Frontend API URL -->
<script
async
crossorigin="anonymous"
data-clerk-publishable-key="YOUR_PUBLISHABLE_KEY"
src="https://YOUR_FRONTEND_API_URL/npm/@clerk/clerk-js@latest/dist/clerk.browser.js"
type="text/javascript"
></script>
<script>
window.addEventListener("load", async function () {
await Clerk.load();
Clerk.openSignUp();
// ...
Clerk.closeSignUp();
});
</script>
Customization
To learn about how to customize Clerk components, see the customization documentation.