Preguntas frecuentes
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
-
¿Debo usar reCAPTCHA Enterprise?
-
reCAPTCHA Enterprise ofrece hasta 10,000 evaluaciones por mes sin costo
y ofrece funciones adicionales.
Otras funciones
como el análisis en tiempo real, que son el mejor punto de partida para la mayoría de los desarrolladores.
Comienza aquí.
-
¿Puedo usar reCAPTCHA con soluciones de terceros?
-
Sí, puedes usar reCAPTCHA (versión que no es de Enterprise) y reCAPTCHA
Enterprise. Por lo general, la solución de terceros solicita tu clave pública.
y tu clave secreta o clave de API. Asegúrate de proporcionar solo tu
clave secreta y la clave de API a terceros de confianza.
-
¿Cómo migrar a reCAPTCHA Enterprise desde la versión 2 o 3?
-
El
proceso de migración
Tarda de 5 a 10 minutos en completarse y no requiere cambios en el código.
-
¿Debo usar reCAPTCHA v2 o v3?
-
reCAPTCHA v3 es para propietarios de sitios que desean obtener más datos sobre su tráfico.
Para obtener más información, consulta la guía para desarrolladores de reCAPTCHA v3.
Admitimos la seguridad y la usabilidad para v2.
Para obtener más información sobre las diferencias de reCAPTCHA v2 y v3, consulta la comparación de versiones.
-
¿reCAPTCHA usa cookies?
-
reCAPTCHA establece una cookie necesaria (_GRECAPTCHA) cuando se ejecuta con el fin de proporcionar su análisis de riesgos.
Si prefieres no usar el dominio www.google.com que puede tener otras cookies configuradas, puedes usar www.recaptcha.net.
-
¿Existe algún límite diario o de QPS para el uso de reCAPTCHA?
-
Si quieres realizar más de 1,000 llamadas por segundo o 1000,000 llamadas por mes, debes usar
reCAPTCHA Enterprise o completa
este formulario y espera a que se apruebe la excepción.
Si la clave de sitio supera las 1,000 QPS, es posible que no se procesen algunas solicitudes.
Si la clave de sitio v3 supera su cuota mensual, es posible que site_verify no se abra.
para mostrar una puntuación estática de 0.9 y el mensaje de error «Cuota gratuita excedida».
para el resto del mes. No hay indicaciones visibles para el usuario cuando
Los sitios de la v3 superan la cuota.
Si la clave de sitio v2 excede su cuota mensual, se aplicará
Es posible que este mensaje se muestre a los usuarios en el widget de reCAPTCHA durante el resto
del mes: “Este sitio supera la cuota de reCAPTCHA”.
Antes de que se aplique la cuota, los propietarios de los sitios recibirán una notificación por correo electrónico tres veces.
y se les otorgó al menos 90 días para migrar a reCAPTCHA Enterprise.
Se considera que las claves de sitio excedieron la cuota si hay más de 1,000,000 de llamadas por mes
para cualquier dominio. Esto incluye si este volumen se distribuye entre múltiples
claves en el mismo dominio.
-
Quiero ocultar la insignia de reCAPTCHA. ¿Qué se permite?
-
Puedes ocultar la insignia siempre que incluyas la marca reCAPTCHA de forma visible en el flujo de usuarios. Incluya el siguiente texto:
This site is protected by reCAPTCHA and the Google
<a href="https://policies.google.com/privacy">Privacy Policy</a> and
<a href="https://policies.google.com/terms">Terms of Service</a> apply.
Por ejemplo:
Nota: Si eliges ocultar la insignia, usa
.grecaptcha-badge { visibility: hidden; }
-
Quiero ejecutar pruebas automatizadas con reCAPTCHA. ¿Qué debo hacer?
-
En el caso de reCAPTCHA v3, crea una clave diferente para los entornos de pruebas. Es posible que las puntuaciones no sean precisas, ya que reCAPTCHA v3 depende de ver el tráfico real.
Para reCAPTCHA v2, usa las siguientes claves de prueba. Siempre recibirás un mensaje sin CAPTCHA y se aprobarán todas las solicitudes de verificación.
- Clave del sitio: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
- Clave secreta: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
El widget de reCAPTCHA mostrará un mensaje de advertencia para garantizar que no se use para el tráfico de producción.
-
¿Cómo puedo evitar ingresar al código reCAPTCHA cuando depuro mi sitio?
-
Para evitar ingresar al código de reCAPTCHA mientras depuras otro JavaScript en tu sitio, agrega la secuencia de comandos de reCAPTCHA /recaptcha__.+\.js$ a la lista de elementos ignorados de tu navegador. Para obtener instrucciones para Chrome, consulte Cómo ignorar una lista personalizada de secuencias de comandos. Hay funciones similares disponibles en otros navegadores.
-
¿Cómo puedo obtener más información sobre el tráfico de mi sitio web?
-
reCAPTCHA informa estadísticas diarias en la Consola del administrador.
-
¿Puedo usar reCAPTCHA en todo el mundo?
-
Sí, utiliza "www.recaptcha.net" en su código cuando se muestre "www.google.com" no son accesibles.
- Primero, reemplaza <script src="https://www.google.com/recaptcha/api.js"></script> con <script src="https://www.recaptcha.net/recaptcha/api.js"></script>
- Luego, aplica el mismo procedimiento en cualquier otro lugar en el que se use "www.google.com/recaptcha/". en tu sitio.
-
-
Sí. reCAPTCHA ofrece dos temas, claro y oscuro, como se muestra a continuación. Para elegir un tema, simplemente
establece el atributo data-theme en el archivo grecaptcha.render
según el parámetro de configuración.
Tema claro:
Tema oscuro:
-
¿Cómo puedo personalizar reCAPTCHA v3?
-
La API de JavaScript disponible para reCAPTCHA invisible también funciona para v3. Simplemente usa la API de JavaScript para renderizar explícitamente reCAPTCHA con una clave de sitio v3 para acceder a opciones como reposicionar la insignia o cambiar el tema.
Cuando renderices reCAPTCHA v3 con este método, recuerda establecer el parámetro size en 'invisible' y usar el ID de cliente que muestra grecaptcha.render cuando llames a grecaptcha.execute en lugar de la clave del sitio.
-
-
Si ves este error, la clave de tu sitio de reCAPTCHA ya no es válida. Para activarlo, haz lo siguiente:
registra una clave nueva y sigue las instrucciones que se indican en esa página.
-
Recibo un SecurityError no detectado: se bloqueó un fotograma con el origen "https://www.google.com" accedan a un marco con origen "<yourdomain>". ¿Qué debo hacer?
-
Esto suele ocurrir si el elemento HTML del widget de reCAPTCHA se quita de manera programática después de que el usuario final hace clic en la casilla de verificación. Te recomendamos usar la función de JavaScript grecaptcha.reset() para restablecer el widget de reCAPTCHA.
-
Uso la Política de Seguridad del Contenido (CSP) en mi sitio web. ¿Cómo puedo configurarlo para que funcione con reCAPTCHA?
-
Recomendamos usar el enfoque basado en nonce documentado con CSP3.
Asegúrate de incluir tu nonce en la etiqueta de secuencia de comandos api.js de reCAPTCHA; nosotros nos encargaremos del resto.
Nota: reCAPTCHA también funciona con 'strict-dynamic' en los navegadores compatibles.
También puedes agregar los siguientes valores a las directivas:
- script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
- frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
-
Recibo un error que indica que "Localhost no está en la lista de dominios compatibles". ¿Qué debo hacer?
-
Los dominios localhost no son compatibles de forma predeterminada. Si deseas seguir brindando asistencia por
puedes agregarlos a la lista de dominios compatibles para tu clave de sitio. Ve a la sección
Consola de reCAPTCHA Enterprise
o a la consola de reCAPTCHA, según corresponda,
para actualizar la lista de dominios compatibles. Recomendamos usar claves independientes para el desarrollo
producción, y solo permitir localhost en la clave de tu sitio de desarrollo.
-
Solo en iOS 10, ¿la página se desplaza a la parte inferior cuando el usuario completa el desafío?
-
Este es un error que afecta el problema de Apple y que ya les informamos. Solo afecta a los usuarios de iOS 10 y solo a algunos sitios. Si esto te afecta, una solución alternativa es mover el widget de reCAPTCHA hacia arriba o hacia abajo en la página, o usar reCAPTCHA v3.
-
¿Es posible que mi computadora o red estén enviando consultas automatizadas?
-
Si se te redireccionó a esta página desde el widget de reCAPTCHA, habrías visto un mensaje que dice "Lo sentimos, pero es posible que tu computadora o red estén enviando consultas automatizadas. Para proteger a nuestros usuarios, no podemos procesar tu solicitud en este momento".
Lamentablemente, esto puede sucederles a los usuarios buenos por las siguientes razones:
- Es posible que estés en una red compartida que se está usando de forma inadecuada
- Es posible que tu proveedor de servicios de Internet te haya asignado recientemente una dirección IP sospechosa
- Es posible que el sitio al que intentas acceder esté sufriendo ataques intensos
Para solucionar estos problemas, consulta la página de ayuda sobre tráfico inusual o vuelve a intentarlo más tarde.
-
¿Qué nombres de acción son válidos?
-
Las acciones solo pueden contener caracteres alfanuméricos, barras diagonales y guiones bajos.
Las acciones no deben ser específicas para el usuario.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003ereCAPTCHA Enterprise offers a free tier with 10,000 assessments per month and advanced features like real-time analytics.\u003c/p\u003e\n"],["\u003cp\u003eYou can migrate to reCAPTCHA Enterprise from v2 or v3 in 5-10 minutes without code changes.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA v3 provides website traffic insights while v2 focuses on security and usability.\u003c/p\u003e\n"],["\u003cp\u003ereCAPTCHA sets a necessary cookie but you can use www.recaptcha.net instead of www.google.com to avoid other potential Google cookies.\u003c/p\u003e\n"],["\u003cp\u003eTo hide the reCAPTCHA badge, ensure the reCAPTCHA branding is visible in the user flow with the provided text snippet.\u003c/p\u003e\n"]]],["reCAPTCHA offers Enterprise and non-Enterprise versions, with the former providing 10,000 free assessments monthly and features like real-time analytics. Migration to Enterprise is quick and doesn't require code changes. reCAPTCHA v3 provides more traffic data than v2. Both versions are compatible with third-party solutions, using public and secret/API keys. reCAPTCHA sets a necessary cookie, but an alternative domain is available. There are rate and volume limits; exceeding them may cause errors. You can hide the badge with specific text included, set testing keys, and use multiple ways to customize its behaviour.\n"],null,["# Frequently Asked Questions\n\n### Should I use reCAPTCHA Enterprise?\n\n\n:\n reCAPTCHA Enterprise offers up to 10,000 assessments per month at no cost\n and also provides additional features.\n [Other features](https://cloud.google.com/recaptcha-enterprise/docs/compare-versions)\n such as real time analytics provide the best place to start for most developers.\n [Get started here.](https://www.google.com/recaptcha/admin/enterprise)\n\n\n### Can I use reCAPTCHA with third party solutions?\n\n\n:\n Yes, you can use both reCAPTCHA (non-Enterprise version) and reCAPTCHA\n Enterprise. Typically the third party solution asks for your public key\n and either your secret key or your API key. Make sure to only provide your\n secret key and API key to trusted third parties.\n\n\n### How to migrate to reCAPTCHA Enterprise from v2 or v3?\n\n\n:\n The [migration process](http://cloud.google.com/recaptcha-enterprise/docs/migrate-recaptcha)\n takes 5-10 minutes to complete and requires no code changes.\n\n\n### Should I use reCAPTCHA v2 or v3?\n\n\n:\n reCAPTCHA v3 is for site owners who want more data about their traffic.\n For more information, see the [reCAPTCHA v3 developer guide](/recaptcha/docs/v3).\n\n We support security and usability for v2.\n\n\n For more information about reCAPTCHA v2 and v3 differences, see [versions comparison](/recaptcha/docs/versions).\n\n\n### Does reCAPTCHA use cookies?\n\n\n:\n reCAPTCHA sets a necessary cookie (_GRECAPTCHA) when executed for the purpose of providing its risk analysis.\n If you prefer to not use the www.google.com domain which may have other cookies set, you can use www.recaptcha.net instead.\n\n\n### Are there any QPS or daily limits on my use of reCAPTCHA?\n\n\n:\n If you wish to make more than 1000 calls per second or 1000000 calls per month, you must use\n [reCAPTCHA Enterprise](https://cloud.google.com/recaptcha-enterprise) or fill out\n [this form](https://forms.gle/caCX5Sgkz2N1maGa9) and wait for an exception approval.\n If a site key exceeds 1000 QPS, then some requests may not be processed.\n If a v3 site key exceeds its monthly quota, then site_verify may fail open\n by returning a static score 0.9 and an error message \\`\"Over free quota.\"\\`\n for the remainder of the month. There are no user-visible indications when\n v3 sites are over quota.\n If a v2 site key exceeds its monthly quota, then the following or a similar\n message may be displayed to users in the reCAPTCHA widget for the remainder\n of the month: \\`This site is exceeding reCAPTCHA quota.\\`\n Before quota is enforced, site owners will be notified by email three times\n and given at least 90 days to migrate to reCAPTCHA Enterprise.\n Site keys are considered over quota if more than 1000000 calls per month are\n used for any domain. This includes if this volume is spread across multiple\n keys on the same domain.\n\n\n### I'd like to hide the reCAPTCHA badge. What is allowed?\n\n\n: You are allowed to hide the badge as long as you include the reCAPTCHA branding visibly in the user flow. Please include the following text:\n\n ```html\n This site is protected by reCAPTCHA and the Google\n \u003ca href=\"https://policies.google.com/privacy\"\u003ePrivacy Policy\u003c/a\u003e and\n \u003ca href=\"https://policies.google.com/terms\"\u003eTerms of Service\u003c/a\u003e apply.\n ```\n\n For example:\n\n **Note:** if you choose to hide the badge, please use \n\n ```css\n .grecaptcha-badge { visibility: hidden; }\n ```\n\n \u003cbr /\u003e\n\n\n### I'd like to run automated tests with reCAPTCHA. What should I do?\n\n\n: For reCAPTCHA v3, create a separate key for testing environments. Scores may not be accurate as reCAPTCHA v3 relies on seeing real traffic.\n\n For reCAPTCHA v2, use the following test keys. You will always get No CAPTCHA and all verification requests will pass.\n\n - Site key: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI\n - Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe\n\n The reCAPTCHA widget will show a warning message to ensure it's not used for production traffic.\n\n\n### How can I avoid stepping into reCAPTCHA code when debugging my site?\n\n\n: To avoid stepping into the reCAPTCHA code while debugging other JavaScript on your site, add the reCAPTCHA script `/recaptcha__.+\\.js$` to your browser's ignore list. For instructions for Chrome, refer to [Ignore a custom list of scripts](https://developer.chrome.com/docs/devtools/settings/ignore-list). Similar features are available in other browsers.\n\n\n### How can I see more about my website's traffic?\n\n\n: reCAPTCHA reports daily stats in the [admin console](https://www.google.com/recaptcha/admin).\n\n\n### Can I use reCAPTCHA globally?\n\n\n: Yes, please use \"www.recaptcha.net\" in your code in circumstances when \"www.google.com\" is not accessible.\n\n - First, replace \\\u003cscript src=\"https://**www.google.com** /recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e with \\\u003cscript src=\"https://**www.recaptcha.net**/recaptcha/api.js\"\\\u003e\\\u003c/script\\\u003e\n - After that, apply the same to everywhere else that uses \"www.google.com/recaptcha/\" on your site.\n\n\n### Can I customize the reCAPTCHA widget or badge?\n\n\n: Yes. reCAPTCHA offers two themes, light and dark, as shown below. To choose a theme, simply\n set the data-theme attribute in the [grecaptcha.render\n parameter](/recaptcha/docs/display#render_param).\n\n Light theme:\n\n Dark theme:\n\n\n### How can I customize reCAPTCHA v3?\n\n\n: The [JavaScript API](/recaptcha/docs/invisible#js_api) available for Invisible reCAPTCHA also works for v3. Simply use the JavaScript API to explicitly render reCAPTCHA with a v3 site key to access options such as repositioning the badge or changing the theme.\n\n When rendering reCAPTCHA v3 with this method, remember to set the `size` parameter to `'invisible'` and use the client ID returned by `grecaptcha.render` when calling `grecaptcha.execute` instead of the site key.\n\n\n### Recently my reCAPTCHA widget started displaying \"Invalid site key\". What's happening?\n\n\n:\n\n If you are seeing this error, your reCAPTCHA site key is no longer valid. To activate, please\n [register a new key](https://www.google.com/recaptcha/admin) and follow the [instructions](/recaptcha/intro) on that page.\n\n\n### I'm getting an uncaught SecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\". What should I do?\n\n\n: 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.reset()](/recaptcha/docs/display#js_api) javascript function to reset the reCAPTCHA widget.\n\n\n### I'm using Content-Security-Policy (CSP) on my website. How can I configure it to work with reCAPTCHA?\n\n\n: We recommend using the nonce-based approach documented with [CSP3](https://w3c.github.io/webappsec-csp/#framework-directive-source-list).\n Make sure to include your nonce in the reCAPTCHA [api.js](/recaptcha/docs/display#auto_render) script tag, and we'll handle the rest.\n\n Note: reCAPTCHA also works with ['strict-dynamic'](https://w3c.github.io/webappsec-csp/#strict-dynamic-usage) on browsers that support it.\n\n Alternatively, please add the following values to the directives:\n\n - **script-src** https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/\n - **frame-src** https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/\n\n\n### I'm getting an error \"Localhost is not in the list of supported domains\". What should I do?\n\n\n: localhost domains are not supported by default. If you wish to continue supporting them for\n development you can add them to the list of supported domains for your site key. Go to the\n [reCAPTCHA Enterprise console](https://console.cloud.google.com/security/recaptcha)\n or to the [reCAPTCHA console](https://www.google.com/recaptcha/admin), as appropriate,\n to update your list of supported domains. We advise to use separate keys for development and\n production, and to only allow localhost on your development site key.\n\n\n### Only on iOS 10, the page scrolls to the bottom when the user completes the challenge?\n\n\n: This is a focusing bug on Apple's side that we've reported to them. It affects users only on iOS 10 and only on some sites. If you are affected, a workaround is to move the reCAPTCHA widget higher or lower on the page, or use [reCAPTCHA v3](/recaptcha/docs/v3).\n\n\n### My computer or network may be sending automated queries?\n\n\n: If you were directed to this page from the reCAPTCHA widget, you would have seen a message that said \"We're sorry, but your computer or network may be sending automated queries. To protect our users, we can't process your request right now.\"\n\n This can unfortunately happen to good users for a few reasons:\n\n - You may be on a shared network that is being used abusively\n - Your internet service provider may have recently assigned you a suspicious IP address\n - The site you are trying to access may be currently under heavy attack\n\n To troubleshoot these issues, please look at the [unusual traffic help page](https://support.google.com/websearch/answer/86640), or try again later.\n\n\n### What action names are valid?\n\n\n: Actions might contain only alphanumeric characters, slashes, and underscores.\n Actions must not be user-specific."]]
