Skip to content
Front User Submit
Menu

Cloudflare Turnstile field

Protect a form from spam with Cloudflare Turnstile, a free captcha that most visitors pass without solving a puzzle.

The Cloudflare Turnstile field adds a Turnstile check to the form. The post is saved only after Cloudflare confirms the check. Most visitors pass it without clicking anything. It is in the Custom Fields group and is free. It can be used once per form.

Turnstile is free. You do not need to host your site on Cloudflare.

1. Get the keys

  1. Log in to the Cloudflare dashboard or create a free account.
  2. Open Turnstile and add a widget.
  3. Add your domain.
  4. Copy the Site Key and the Secret Key.

2. Add the field

  1. Open the form: Front User Submit → Post Forms → Edit.
  2. In the Custom Fields group, add Cloudflare Turnstile.
  3. Fill in the settings and click Save.
Setting What it does
Site Key From Cloudflare
Secret Key From Cloudflare
Error Message Shown when the check fails. Default “Please complete the captcha properly.”
Theme Auto (follows the visitor’s light or dark mode), Light or Dark
Size Normal, Flexible (as wide as the form) or Compact. Normal and Flexible need 300 px: in a narrower form (small phones) the widget is shown compact.
Language Language code, for example de or fr (list). Leave it empty to use the visitor’s language.

The widget is shown only when Site Key is filled in. Without keys nobody can pass the check: visitors see nothing, and administrators see a reminder in the form to add the keys. Test the form in a logged-out browser window.

How the check works

When the form is sent, the plugin asks Cloudflare (siteverify) whether the answer is valid. If it is not, the post is not saved and the user sees the Error Message. If your server cannot reach Cloudflare, the user sees “Failed to verify captcha”.

The check is reset after each submit. If the form shows an error, the visitor passes the check again before sending the form a second time.

Other spam protection: hCaptcha, reCAPTCHA v2, post status Pending, AI moderation (Pro).

Last updated 2026-11-18