Cloudflare Docs
Turnstile
Cloudflare Docs
Turnstile
Search icon (depiction of a magnifying glass)
GitHub icon
Visit Turnstile on GitHub
Set theme to dark (⇧+D)
  1. Products
  2. Turnstile
  3. Reference
  4. Widget types

Widget types

Every instance of Turnstile belongs to a Turnstile widget. It is configured on a per-widget level. Every widget has a mode, a label, a sitekey, and a secret key.

The 3 modes for Turnstile are Managed, Non-Interactive, and Invisible.

Cloudflare will use information from the visitor to decide if an interactive challenge should be used. If we show an interaction, the user will be prompted to check a box (no images or text to decipher).

​​ Light mode

Managed challenge Verifying the challenge Successful managed challenge

​​ Dark mode

Managed challenge Verifying the challenge Successful managed challenge

​​ Non-Interactive

Users will see a widget with a loading bar while the browser challenges run. Users will never be required or prompted to interact with the widget.

​​ Light mode

Verifying the challenge Successful managed challenge

​​ Dark mode

Verifying the challenge Successful managed challenge

​​ Invisible

Users will not see a widget or any indication that an invisible browser challenge is in progress. Invisible challenges should take a few seconds to complete.