Migrating from reCAPTCHA Classic to Google Cloud Console
Why do you need to migrate?
Google has announced that all reCAPTCHA Classic keys must be migrated to Google Cloud Console by the end of 2025. This migration aims to:
✔️ Unify all reCAPTCHA users under a single set of terms and pricing structures.
✔️ Provide better security with advanced monitoring, logging, and auditing features.
✔️ Improve access control through the Google Cloud console.
Google will automatically create a Cloud project and associate your keys when the time comes, but manual migration is recommended so you can choose the project yourself.
Now, let’s go step by step to migrate your reCAPTCHA in PrestaShop.
Step 1: Check your current reCAPTCHA implementation
Before migrating, check how your PrestaShop site is using reCAPTCHA.
Check if you are using a PrestaHero module
If you are using any of the following PrestaHero modules, they may have built-in reCAPTCHA functionality:
One Page Checkout & Social Login
Live Chat, Contact Form & Ticket System
What to check?
- If you are using Image CAPTCHA, you do not need to change anything.
- If you are using reCAPTCHA v2 or v3, you need to migrate to Google Cloud Console.
Check for Custom reCAPTCHA integrations
If your site has a custom reCAPTCHA implementation (e.g., in the theme or a custom module):
- Look for the reCAPTCHA API keys in the code.
- Identify whether it’s using reCAPTCHA v2 or v3.
📌 If you confirm that your site is using reCAPTCHA v2 or v3, proceed to Step 2 to migrate.
Step 2: Create a reCAPTCHA key in Google Cloud Console
Since Google has moved reCAPTCHA management to Google Cloud Console, you need to create a new key there.
Enable reCAPTCHA in Google Cloud
1. Go to Google Cloud Console
2. Sign in with your Google account.
3. Create a new project (if you don’t have one yet):
- Click the project selector dropdown at the top.
- Click New Project, and enter a meaningful name (e.g., "My PrestaShop Store").
- Click Create.
Make sure 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.
Enable reCAPTCHA Enterprise
1. In the Google Cloud Console, go to the reCAPTCHA Enterprise API page.
2. Verify that the name of your project appears in the project selector at the top of the page. If you don't see the name of your project, click the project selector, and then select your project.
3. Click Enable.
Step 3: Migrate your reCAPTCHA key
Now that you’ve set up Google Cloud Console and enabled reCAPTCHA Enterprise, it’s time to migrate your existing reCAPTCHA key.
Check your permissions
To migrate a reCAPTCHA key, your Google account must meet the following requirements:
✔️ You are listed as an owner of the site key in the reCAPTCHA Admin Console.
✔️ You have one of these IAM roles in your Google Cloud project:
- Project Owner (roles/owner)
- Project Editor (roles/editor)
- reCAPTCHA Admin (roles/recaptchaenterprise.admin)
If you don’t have the required role, ask your administrator to grant access or follow Google’s guide on managing IAM roles.
Migrate your reCAPTCHA Classic key
Follow these steps to upgrade your existing reCAPTCHA Classic key to reCAPTCHA Enterprise:
Step 1: Go to the reCAPTCHA page in Google Cloud Console
Step 2: Ensure the correct Google Cloud project is selected:
- Look at the top navigation bar for the resource selector (project dropdown).
- If your project is not selected, click the dropdown and choose your Google Cloud project.
Step 3: Find the reCAPTCHA Classic key to migrate:
- Scroll down to the Classic keys section.
- Identify the key you want to migrate.
- Click "Upgrade key" next to the selected key.
- Confirm the migration by clicking "Confirm".
Step 4: Verify that your key has been migrated
After migration, confirm that your key appears under reCAPTCHA keys in Google Cloud Console:
Step 1: Go to the reCAPTCHA page
Step 2: Look for your migrated key in the reCAPTCHA keys section (not the Classic keys section).
Important:
- Do NOT delete your site key from the reCAPTCHA Admin Console or Google Cloud Console.
- If you delete the key, it will be removed from both platforms and your site will lose reCAPTCHA protection.