useSignUp() | Clerk

The useSignUp hook gives you access to the SignUp object, which allows you to check the current state of a sign up. This is also useful for creating a custom sign up flow.

Usage

pages/sign-up.tsx
import { useSignUp } from "@clerk/nextjs";
 
export default function SignUpStep() {
  const { isLoaded, signUp } = useSignUp();
 
  if (!isLoaded) {
    // handle loading state
    return null;
  }
 
  return <div>The current sign up attempt status is {signUp.status}.</div>;
}

pages/signup.tsx
import { useSignUp } from "@clerk/nextjs";
import { useState } from "react";
 
export default function SignUp() {
  const [emailAddress, setEmailAddress] = useState("");
  const [password, setPassword] = useState("");
 
  const { isLoaded, signUp, setActive } = useSignUp();
 
  if (!isLoaded) {
    // handle loading state
    return null;
  }
 
  async function submit(e) {
    e.preventDefault();
    // Check the sign up response to
    // decide what to do next.
    await signUp
      .create({
        emailAddress,
        password,
      })
      .then((result) => {
        if (result.status === "complete") {
          console.log(result);
          setActive({ session: result.createdSessionId });
        } else {
          console.log(result);
        }
      })
      .catch((err) => console.error("error", err.errors[0].longMessage));
  }
 
  return (
    <form onSubmit={submit}>
      <div>
        <label htmlFor="email">Email</label>
        <input
          type="email"
          value={emailAddress}
          onChange={(e) => setEmailAddress(e.target.value)}
        />
      </div>
      <div>
        <label htmlFor="password">Password</label>
        <input
          type="password"
          value={password}
          onChange={(e) => setPassword(e.target.value)}
        />
      </div>
      <div>
        <button>Sign up</button>
      </div>
    </form>
  );
}

sign-up-step.tsx
import { useSignUp } from "@clerk/clerk-react";
 
export default function SignUpStep() {
  const { isLoaded, signUp } = useSignUp();
 
  if (!isLoaded) {
    // handle loading state
    return null;
  }
 
  return <div>The current sign up attempt status is {signUp.status}.</div>;
}

signup.tsx
import { useSignUp } from "@clerk/clerk-react";
import { useState } from "react";
 
export default function SignUp() {
  const [emailAddress, setEmailAddress] = useState("");
  const [password, setPassword] = useState("");
 
  const { isLoaded, signUp, setActive } = useSignUp();
 
  if (!isLoaded) {
    // handle loading state
    return null;
  }
 
  async function submit(e) {
    e.preventDefault();
    // Check the sign up response to
    // decide what to do next.
    await signUp
      .create({
        emailAddress,
        password,
      })
      .then((result) => {
        if (result.status === "complete") {
          console.log(result);
          setActive({ session: result.createdSessionId });
        } else {
          console.log(result);
        }
      })
      .catch((err) => console.error("error", err.errors[0].longMessage));
  }
 
  return (
    <form onSubmit={submit}>
      <div>
        <label htmlFor="email">Email</label>
        <input
          type="email"
          value={emailAddress}
          onChange={(e) => setEmailAddress(e.target.value)}
        />
      </div>
      <div>
        <label htmlFor="password">Password</label>
        <input
          type="password"
          value={password}
          onChange={(e) => setPassword(e.target.value)}
        />
      </div>
      <div>
        <button>Sign up</button>
      </div>
    </form>
  );
}

Variables	Description
isLoaded	A boolean that until Clerk loads and initializes, will be set to false. Once Clerk loads, isLoaded will be set to true
setActive	A function that sets the active session, is most cases this should be used over setSession()
setSession	A function that sets the active session, this should
signUp	An object that contains the current sign up attempt status and methods to create a new sign up attempt.

Usage

Check the current sign up status

Sign up a user with a custom flow

Check the current sign up status

Sign up a user with a custom flow