useUpdateEmail

const { update, success } = useUpdateEmail();

await update(newEmail, { currentPassword }); // password account
await update(newEmail); // OAuth account

{
  success && <p>Check {newEmail} to confirm the change.</p>;
}

Returns

update(newEmail, { currentPassword? }) resolves to { success: true } or a failure result. Also exposes loading, error, and success.

success means "email sent"

This uses Firebase's verifyBeforeUpdateEmail. Firebase mails a verification link to the new address, and the change lands only when it's clicked.

So success means the verification email went out — not that the email changed. Word your UI accordingly.

Reauthentication

Pass currentPassword for automatic reauthentication. Omit it for OAuth-only accounts, which have no password, and handle a stale session with useReauthenticate.

Options