Client API

Everything in recaptcha-next/client. These run in the browser, in Client Components.

RecaptchaField

Renders a hidden input and keeps a fresh token in it.

Prop	Default	Description
action	required	Action name. Check the same name on the server.
siteKey	NEXT_PUBLIC_RECAPTCHA_SITE_KEY	Public site key. Without a key the field renders nothing.
name	g-recaptcha-response	Name of the hidden input.
lazy	false	Load Google’s script only when the form is near the viewport.
lazyRootMargin	200px	How early lazy loading starts.
refreshIntervalMs	90000	Time between token refreshes. Google tokens last two minutes.
onTokenGenerated		Called with each new token. Inline functions are safe.
onError		Called when the script fails to load or a token cannot be made.

useRecaptcha

const { status, error, execute } = useRecaptcha({ action: "contact" });

Options are action, siteKey and enabled. It returns:

Value	Description
status	idle, loading, ready or error.
error	The error when the status is error, otherwise null.
execute	Returns a promise of a fresh token. Call it when the user submits the form.

Use it when you build the FormData yourself. See Custom FormData.