Sign-up
Email/password + email verification
The following example demonstrates a sign-up flow with email and password fields. After the user submits their email and password, they are prompted to verify their email address.
Before you build your sign-up flow, you need to configure the appropriate settings in Clerk:
- Navigate to the Clerk Dashboard.
- In the navigation sidebar, select User & Authentication > Email, Phone, Username.
- In the Contact information section, ensure that only Email address and Password are enabled.
'use client'
import * as Clerk from '@clerk/elements/common'
import * as SignUp from '@clerk/elements/sign-up'
export default function SignUpPage() {
return (
<div className="grid w-full flex-grow items-center bg-black px-4 sm:justify-center">
<SignUp.Root>
<SignUp.Step
name="start"
className="w-full space-y-6 rounded-2xl bg-neutral-900 bg-[radial-gradient(circle_at_50%_0%,theme(colors.white/10%),transparent)] px-4 py-10 ring-1 ring-inset ring-white/5 sm:w-96 sm:px-8"
>
<header className="text-center">
<svg
xmlns="http://www.w3.org/2000/svg"
fill="none"
viewBox="0 0 40 40"
className="mx-auto size-10"
>
<mask id="a" width="40" height="40" x="0" y="0" maskUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="20" fill="#D9D9D9" />
</mask>
<g fill="#fff" mask="url(#a)">
<path d="M43.5 3a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V2ZM43.5 8a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V7ZM43.5 13a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 18a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 23a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 28a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 33a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 38a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1Z" />
<path d="M27 3.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 8.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM23 13.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM21.5 18.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM20.5 23.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM22.5 28.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 33.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM27 38.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2Z" />
</g>
</svg>
<h1 className="mt-4 text-xl font-medium tracking-tight text-white">
Create an account
</h1>
</header>
<Clerk.GlobalError className="block text-sm text-red-400" />
<div className="space-y-4">
<Clerk.Field name="emailAddress" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-white">Email address</Clerk.Label>
<Clerk.Input
type="text"
required
className="w-full rounded-md bg-neutral-900 px-3.5 py-2 text-sm text-white outline-none ring-1 ring-inset ring-zinc-700 hover:ring-zinc-600 focus:bg-transparent focus:ring-[1.5px] focus:ring-blue-400 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
<Clerk.Field name="password" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-white">Password</Clerk.Label>
<Clerk.Input
type="password"
required
className="w-full rounded-md bg-neutral-900 px-3.5 py-2 text-sm text-white outline-none ring-1 ring-inset ring-zinc-700 hover:ring-zinc-600 focus:bg-transparent focus:ring-[1.5px] focus:ring-blue-400 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
</div>
<SignUp.Captcha className="empty:hidden" />
<SignUp.Action
submit
className="relative isolate w-full rounded-md bg-blue-500 px-3.5 py-1.5 text-center text-sm font-medium text-white shadow-[0_1px_0_0_theme(colors.white/10%)_inset,0_0_0_1px_theme(colors.white/5%)] outline-none before:absolute before:inset-0 before:-z-10 before:rounded-md before:bg-white/5 before:opacity-0 hover:before:opacity-100 focus-visible:outline-[1.5px] focus-visible:outline-offset-2 focus-visible:outline-blue-400 active:text-white/70 active:before:bg-black/10"
>
Sign Up
</SignUp.Action>
<p className="text-center text-sm text-zinc-400">
Have an account?{' '}
<a
href="#"
className="font-medium text-white decoration-white/20 underline-offset-4 outline-none hover:underline focus-visible:underline"
>
Sign in
</a>
</p>
</SignUp.Step>
<SignUp.Step
name="verifications"
className="w-full space-y-6 rounded-2xl bg-neutral-900 bg-[radial-gradient(circle_at_50%_0%,theme(colors.white/10%),transparent)] px-4 py-10 ring-1 ring-inset ring-white/5 sm:w-96 sm:px-8"
>
<header className="text-center">
<svg
xmlns="http://www.w3.org/2000/svg"
fill="none"
viewBox="0 0 40 40"
className="mx-auto size-10"
>
<mask id="a" width="40" height="40" x="0" y="0" maskUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="20" fill="#D9D9D9" />
</mask>
<g fill="#fff" mask="url(#a)">
<path d="M43.5 3a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V2ZM43.5 8a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V7ZM43.5 13a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 18a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 23a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 28a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 33a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 38a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1Z" />
<path d="M27 3.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 8.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM23 13.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM21.5 18.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM20.5 23.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM22.5 28.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 33.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM27 38.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2Z" />
</g>
</svg>
<h1 className="mt-4 text-xl font-medium tracking-tight text-white">
Verify email code
</h1>
</header>
<Clerk.GlobalError className="block text-sm text-red-400" />
<SignUp.Strategy name="email_code">
<Clerk.Field name="code" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-white">Email code</Clerk.Label>
<Clerk.Input
required
className="w-full rounded-md bg-neutral-900 px-3.5 py-2 text-sm text-white outline-none ring-1 ring-inset ring-zinc-700 hover:ring-zinc-600 focus:bg-transparent focus:ring-[1.5px] focus:ring-blue-400 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
<SignUp.Action
submit
className="relative isolate w-full rounded-md bg-blue-500 px-3.5 py-1.5 text-center text-sm font-medium text-white shadow-[0_1px_0_0_theme(colors.white/10%)_inset,0_0_0_1px_theme(colors.white/5%)] outline-none before:absolute before:inset-0 before:-z-10 before:rounded-md before:bg-white/5 before:opacity-0 hover:before:opacity-100 focus-visible:outline-[1.5px] focus-visible:outline-offset-2 focus-visible:outline-blue-400 active:text-white/70 active:before:bg-black/10"
>
Finish registration
</SignUp.Action>
</SignUp.Strategy>
<p className="text-center text-sm text-zinc-400">
Have an account?{' '}
<a
href="#"
className="font-medium text-white decoration-white/20 underline-offset-4 outline-none hover:underline focus-visible:underline"
>
Sign in
</a>
</p>
</SignUp.Step>
</SignUp.Root>
</div>
)
}Email/password + username + email verification
The following example demonstrates a sign-up flow with email, password, and username fields. After the user submits their email, password, and username, they are prompted to verify their email address.
Before you build your sign-up flow, you need to configure the appropriate settings in Clerk:
- Navigate to the Clerk Dashboard.
- In the navigation sidebar, select User & Authentication > Email, Phone, Username.
- In the Contact information section, ensure that only Email address and Password are enabled.
- In the Username section, ensure that Username is enabled.
'use client'
import * as Clerk from '@clerk/elements/common'
import * as SignUp from '@clerk/elements/sign-up'
export default function SignUpPage() {
return (
<div className="grid w-full flex-grow items-center bg-zinc-100 px-4 sm:justify-center">
<SignUp.Root>
<SignUp.Step
name="start"
className="w-full space-y-6 rounded-2xl bg-white px-4 py-10 shadow-md ring-1 ring-black/5 sm:w-96 sm:px-8"
>
<header className="text-center">
<svg
xmlns="http://www.w3.org/2000/svg"
fill="none"
viewBox="0 0 40 40"
className="mx-auto size-10 text-zinc-950"
aria-hidden
>
<mask id="a" width="40" height="40" x="0" y="0" maskUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="20" fill="#D9D9D9" />
</mask>
<g fill="currentColor" mask="url(#a)">
<path d="M43.5 3a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V2ZM43.5 8a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V7ZM43.5 13a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 18a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 23a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 28a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 33a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 38a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1Z" />
<path d="M27 3.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 8.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM23 13.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM21.5 18.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM20.5 23.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM22.5 28.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 33.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM27 38.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2Z" />
</g>
</svg>
<h1 className="mt-4 text-xl font-medium tracking-tight text-zinc-950">
Create an account
</h1>
</header>
<Clerk.GlobalError className="block text-sm text-red-400" />
<div className="space-y-4">
<Clerk.Field name="emailAddress" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-zinc-950">Email</Clerk.Label>
<Clerk.Input
type="email"
required
className="w-full rounded-md bg-white px-3.5 py-2 text-sm outline-none ring-1 ring-inset ring-zinc-300 hover:ring-zinc-400 focus:ring-[1.5px] focus:ring-zinc-950 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
<Clerk.Field name="password" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-zinc-950">Password</Clerk.Label>
<Clerk.Input
type="password"
required
className="w-full rounded-md bg-white px-3.5 py-2 text-sm outline-none ring-1 ring-inset ring-zinc-300 hover:ring-zinc-400 focus:ring-[1.5px] focus:ring-zinc-950 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
</div>
<SignUp.Action
submit
className="w-full rounded-md bg-zinc-950 px-3.5 py-1.5 text-center text-sm font-medium text-white shadow outline-none ring-1 ring-inset ring-zinc-950 hover:bg-zinc-800 focus-visible:outline-[1.5px] focus-visible:outline-offset-2 focus-visible:outline-zinc-950 active:text-white/70"
>
Sign Up
</SignUp.Action>
<p className="text-center text-sm text-zinc-500">
Already have an account?{' '}
<a
href="#"
className="font-medium text-zinc-950 decoration-zinc-950/20 underline-offset-4 outline-none hover:text-zinc-700 hover:underline focus-visible:underline"
>
Sign in
</a>
</p>
</SignUp.Step>
<SignUp.Step
name="verifications"
className="w-full space-y-6 rounded-2xl bg-white px-4 py-10 shadow-md ring-1 ring-black/5 sm:w-96 sm:px-8"
>
<header className="text-center">
<svg
xmlns="http://www.w3.org/2000/svg"
fill="none"
viewBox="0 0 40 40"
className="mx-auto size-10 text-zinc-950"
aria-hidden
>
<mask id="a" width="40" height="40" x="0" y="0" maskUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="20" fill="#D9D9D9" />
</mask>
<g fill="currentColor" mask="url(#a)">
<path d="M43.5 3a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V2ZM43.5 8a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V7ZM43.5 13a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 18a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 23a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 28a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 33a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 38a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1Z" />
<path d="M27 3.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 8.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM23 13.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM21.5 18.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM20.5 23.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM22.5 28.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 33.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM27 38.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2Z" />
</g>
</svg>
<h1 className="mt-4 text-xl font-medium tracking-tight text-zinc-950">
Verify email code
</h1>
</header>
<Clerk.GlobalError className="block text-sm text-red-400" />
<SignUp.Strategy name="email_code">
<Clerk.Field name="code" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-zinc-950">Email code</Clerk.Label>
<Clerk.Input
type="otp"
required
className="w-full rounded-md bg-white px-3.5 py-2 text-sm outline-none ring-1 ring-inset ring-zinc-300 hover:ring-zinc-400 focus:ring-[1.5px] focus:ring-zinc-950 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
<SignUp.Action
submit
className="w-full rounded-md bg-zinc-950 px-3.5 py-1.5 text-center text-sm font-medium text-white shadow outline-none ring-1 ring-inset ring-zinc-950 hover:bg-zinc-800 focus-visible:outline-[1.5px] focus-visible:outline-offset-2 focus-visible:outline-zinc-950 active:text-white/70"
>
Verify
</SignUp.Action>
</SignUp.Strategy>
<p className="text-center text-sm text-zinc-500">
Already have an account?{' '}
<a
href="#"
className="font-medium text-zinc-950 decoration-zinc-950/20 underline-offset-4 outline-none hover:text-zinc-700 hover:underline focus-visible:underline"
>
Sign in
</a>
</p>
</SignUp.Step>
<SignUp.Step
name="continue"
className="w-full space-y-6 rounded-2xl bg-white px-4 py-10 shadow-md ring-1 ring-black/5 sm:w-96 sm:px-8"
>
<header className="text-center">
<svg
xmlns="http://www.w3.org/2000/svg"
fill="none"
viewBox="0 0 40 40"
className="mx-auto size-10 text-zinc-950"
aria-hidden
>
<mask id="a" width="40" height="40" x="0" y="0" maskUnits="userSpaceOnUse">
<circle cx="20" cy="20" r="20" fill="#D9D9D9" />
</mask>
<g fill="currentColor" mask="url(#a)">
<path d="M43.5 3a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V2ZM43.5 8a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46V7ZM43.5 13a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 18a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 23a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 28a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 33a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1ZM43.5 38a.5.5 0 0 0 0-1v1Zm0-1h-46v1h46v-1Z" />
<path d="M27 3.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 8.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM23 13.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM21.5 18.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM20.5 23.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM22.5 28.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM25 33.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2ZM27 38.5a1 1 0 1 0 0-2v2Zm0-2h-46v2h46v-2Z" />
</g>
</svg>
<h1 className="mt-4 text-xl font-medium tracking-tight text-zinc-950">
Continue registration
</h1>
</header>
<Clerk.GlobalError className="block text-sm text-red-400" />
<Clerk.Field name="username" className="space-y-2">
<Clerk.Label className="text-sm font-medium text-zinc-950">Username</Clerk.Label>
<Clerk.Input
type="text"
required
className="w-full rounded-md bg-white px-3.5 py-2 text-sm outline-none ring-1 ring-inset ring-zinc-300 hover:ring-zinc-400 focus:ring-[1.5px] focus:ring-zinc-950 data-[invalid]:ring-red-400"
/>
<Clerk.FieldError className="block text-sm text-red-400" />
</Clerk.Field>
<SignUp.Action
submit
className="w-full rounded-md bg-zinc-950 px-3.5 py-1.5 text-center text-sm font-medium text-white shadow outline-none ring-1 ring-inset ring-zinc-950 hover:bg-zinc-800 focus-visible:outline-[1.5px] focus-visible:outline-offset-2 focus-visible:outline-zinc-950 active:text-white/70"
>
Continue
</SignUp.Action>
<p className="text-center text-sm text-zinc-500">
Already have an account?{' '}
<a
href="#"
className="font-medium text-zinc-950 decoration-zinc-950/20 underline-offset-4 outline-none hover:text-zinc-700 hover:underline focus-visible:underline"
>
Sign in
</a>
</p>
</SignUp.Step>
</SignUp.Root>
</div>
)
}Feedback
Last updated on