Cloudflare Docs
Turnstile
Cloudflare Docs
Turnstile
GitHub icon
Edit this page on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Turnstile
  3. Get started

Get started

This guide will get you started on setting up the Turnstile widget.

If you are currently using a CAPTCHA service, you can copy and paste our script wherever you have deployed the existing script today.

​​ Get a sitekey and secret key

To start using the Turnstile widget, you will need to obtain a sitekey and a secret key. The sitekey and secret key are always associated with one widget and cannot be reused for other widgets.

The sitekey is public and used to invoke the Turnstile widget on your site.

The sitekey and secret key are generated upon the creation of a widget, allowing communication between your site and Cloudflare to verify responses for a solved challenge from Turnstile. Make sure you keep the secret key safe for security reasons.

​​ New sites

  1. Log in to the Cloudflare dashboard and select your account.
  2. Go to Turnstile.
  3. Select Add a site and fill out the site name and your website’s hostname or select from your existing websites on Cloudflare.
  4. Select the widget mode.
  5. (Optional) Opt in for pre-clearance support.
  6. Copy your sitekey and secret key.

​​ Existing sites

  1. Log in to the Cloudflare dashboard and select your account.
  2. Go to Turnstile.
  3. In the widget overview, select Settings.
  4. (Optional) Opt in for pre-clearance support.
  5. Copy your sitekey and secret key.

​​ Add the Turnstile widget to your site

To add the Turnstile widget:

  1. Insert the Turnstile script snippet in your HTML’s <head> element:
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>

  1. Render the client-side integration

​​ Validate the server-side response

After you have installed the Turnstile widget on your site, you must configure your server to validate the Turnstile response. Refer to Server-side validation.