Get started
This guide is meant for customers to get started on setting up the Turnstile widget.
If you are currently using a CAPTCHA service, you can simply copy and paste our script wherever you have deployed the existing script today.
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. The secret key should be kept safe and only known to the customer for security purposes.
New sites
- Log in to the Cloudflare dashboard and select your account.
- From the dashboard, select Turnstile > Add a site and fill out the form.
- Copy your sitekey and secret key.
Existing sites
- Log in to the Cloudflare dashboard and select your account.
- From the dashboard, select Turnstile.
- In the widget overview, select Settings.
- Copy your sitekey and secret key.
Add the Turnstile widget to your site
To add the Turnstile widget:
- Insert the JavaScript:
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>