Migrate from reCAPTCHA Classic

This document explains how to migrate an active site key from reCAPTCHA Classic to reCAPTCHA on a Google Cloud project. You can migrate the site key by using either the reCAPTCHA Admin console (recommended) or using the Google Cloud console. The migration process takes 5–10 minutes to complete and requires no code changes.

If you manage your keys in the reCAPTCHA Admin console, then you're using reCAPTCHA Classic. The latest reCAPTCHA features are only available to site keys that are managed within a Google Cloud project. For more information about the available features, see Compare reCAPTCHA tiers.

The following changes occur after you complete the migration process:

• Your site keys are available in a Google Cloud project without any changes.
• Your existing reCAPTCHA integration continues to work without requiring code changes. You can retain the same web page instrumentation and backend calls. However, to access features such as Account defense or Password defense, you must modify your web page instrumentation and backend calls. For more information, see Using reCAPTCHA features after migration.
• You will be charged when you exceed the free monthly allowance of reCAPTCHA, which is 10,000 assessments per month. For more information, see Billing information.

Migrate using the reCAPTCHA Admin console

1. Go to the reCAPTCHA Admin console.

   Go to reCAPTCHA admin console

2. Select the project that you want to migrate the keys to.

3. Select the keys to be migrated.

4. Click Submit.

The Google Cloud console opens with your project and the keys that you migrated.

Migrate using the Google Cloud console

Before you begin

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

   reCAPTCHA requires billing to be linked and enabled on the project for the migration. You can enable billing by using either a credit card or an existing Google Cloud project billing ID. If you require assistance with billing, contact Cloud Billing Support.

3. If you want to run the gcloud CLI outside of the Google Cloud console, install and initialize the gcloud CLI. For instructions, see

   Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

   gcloud init

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Enable the reCAPTCHA Enterprise API

All reCAPTCHA tiers (Essentials, Premium, and Enterprise) run on the reCAPTCHA Enterprise API.