Migrate from reCAPTCHA

Last updated May 5, 2026 If you are using reCAPTCHA today, you can switch seamlessly to Cloudflare Turnstile by following the step-by-step guide below to assist with the upgrade process.

To complete the migration, you must obtain the sitekey and secret key.

Note

Turnstile migration is currently compatible up to reCAPTCHA v2.

Client-side integration

  1. Update the client-side integration by inserting the Turnstile script snippet in your HTML's <head> element.

Turnstile script snippethtml

```html

```

Note

Adding ?compat=recaptcha runs Turnstile in compatibility mode, which enables the following features: - implicit rendering for reCAPTCHA - g-recaptcha-response input name for forms - register the Turnstile API as grecaptcha 2. Locate the grecaptcha.render() calls and replace the sitekey with your Turnstile sitekey.

Note

Turnstile supports: - the render() call - reCAPTCHA v2 invisible mode with the execute() call

Server-side integration

Update the server-side integration by replacing the Siteverify URL.

Replace https://www.google.com/recaptcha/api/siteverify with the following:

https://challenges.cloudflare.com/turnstile/v0/siteverify

Differences to reCAPTCHA's Siteverify

reCAPTCHA supports GET requests using query parameters, such as GET /siteverify?response=<response>&secret=<secret>.

Turnstile's Siteverify endpoint does not support this and only accepts POST requests with a FormData or JSON body.

Refer to server-side validation for more information.

Was this helpful?

YesNo

On this page

Migrate from reCAPTCHA - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/turnstile/migration/recaptcha/#page","headline":"Migrate from reCAPTCHA","description":"Migrate from Google reCAPTCHA to Cloudflare Turnstile.","url":"https://developers.cloudflare.com/turnstile/migration/recaptcha/","inLanguage":"en","image":"https://developers.cloudflare.com/turnstile/migration/recaptcha/og.png?v=1ead042fa390df41","dateModified":"2026-05-05","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Migration"]}

description: Tutorials for integrating Turnstile with WAF, login pages, and testing. title: Tutorials image: https://developers.cloudflare.com/turnstile/tutorials/og.png?v=ce5c4ce967021e0f

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/turnstile/llms.txt
Use this file to discover all available pages before exploring further.