Docs

Guides and reference for recaptcha-next.

Start

Getting started

Add reCAPTCHA v3 to a Next.js form in three steps: install the package, put a field in the form, and verify the token in a Server Action.

Read

Guides

Server Actions

The token travels in the form data, so a Server Action can verify it without any extra request from the browser.

Read

Guides

Lazy loading

Google's script is heavy, and a form far down the page may never be reached. With lazy, the script waits until the form is near the viewport.

Read

Guides

Navigation and the badge

Next.js moves between pages without reloading, so a form can mount and unmount many times in one visit. This page explains what the package does about Google's script when that happens.

Read

Guides

Custom FormData

If you build FormData by hand, or send a fetch request, the hidden input is not included, because it only travels when the browser submits the .

Read

Guides

Testing

Your own tests should not call Google. The server side is built from small parts that you can replace.

Read

Reference

Client API

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

Read

Reference

Server API

Everything in recaptcha-next/server, plus the pure rule exported by the root entry. None of it ships to the browser.

Read