<br />

This document lists common reCAPTCHA integration issues that
developers might encounter when using reCAPTCHA in their environment.

> [!NOTE]
> **Note:** If you're an end user experiencing issues with reCAPTCHA visual challenges, ensure that your browser is up to date or try a different browser. If the problem persists, contact the website's support team.

## Invalid site key or invalid key type

If you see the `Invalid site key` or `Invalid key type` error, check the
following:

- Verify that the key version in the Google Cloud console matches the version configured in your website or third-party CMS plugin (for example, `Website • score` for `v3`, or `Website • checkbox` for `v2 Checkbox`). To check your key version, see [View your key version in the
  Google Cloud console](https://docs.cloud.google.com/recaptcha/docs/reconcile-legacy-terminology#view-key-version).
- If your reCAPTCHA site key is deleted or no longer valid, [create a new key](https://docs.cloud.google.com/recaptcha/docs/create-key-website.md.txt) and update your [CMS plugin](https://docs.cloud.google.com/recaptcha/docs/reconcile-legacy-terminology.md.txt#integrate-cms) or [install the key on your web pages](https://docs.cloud.google.com/recaptcha/docs/instrument-web-pages.md.txt).

## Keys migration failure

Site keys can fail to migrate in one of the following scenarios:

- You've exceeded the number of projects that you
  or your organization can create.

  To resolve this, you can reuse an
  existing project, [request an increase in project creation quota](https://support.google.com/cloud/answer/7283050),
  or wait for the automated migration to complete.
- Your workspace organization has restricted creating of new Google Cloud
  projects.

  To turn on the Google Cloud service in the Google Admin console,
  contact your administrator. For more information, see
  [Turn Google Cloud on or off for users](https://support.google.com/a/answer/182442).

## SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "\&ltyour domain\&gt"

This typically occurs if the reCAPTCHA widget HTML element is
programmatically removed sometime after the end user clicks on the checkbox.
We recommend using the [grecaptcha.enterprise.reset()](https://docs.cloud.google.com/recaptcha/docs/api-ref-checkbox-keys.md.txt#grecaptchaenterprisereset)
JavaScript function to reset the reCAPTCHA widget.

## Localhost is not in the list of supported domains

Localhost domains are not supported by default. If you want to continue
supporting them for development, you can add them to the list of supported
domains for your site key.
Go to the [Google Cloud console](https://console.cloud.google.com/security/recaptcha)
to update your list of supported domains. We advise that you use separate keys for
development and production, and to only allow localhost on your development site
key.

## reCAPTCHA returned BROWSER_ERROR when creating an assessment

`BROWSER_ERROR` tokens occur when the reCAPTCHA script cannot perform
an `execute` operation. In most cases, this is due to a client-side network
failure or timeout. You must retry `execute()` using the JavaScript.