Logical Forms includes Cloudflare Turnstile support. Configure the website's keys once under Logical Forms → Settings → Captcha, then add a CAPTCHA field to each form that should use it.
Prepare the Turnstile widget
Use Get Turnstile keys on the settings page to open Cloudflare. Create or select the widget for the hostname where the form will run, then obtain its site key and secret key. Check the hostname used by an embedded form, especially when moving between local, staging and production sites.
The site key is used by the browser widget. The secret belongs on the server. The plugin's password control does not reveal a saved secret; do not put it in a form field, screenshot or public article.
Save the configuration
| Setting | What it does |
|---|---|
| Provider | Cloudflare Turnstile is the bundled provider. |
| Site key | Enter the widget's site key. |
| Secret key | Enter the corresponding secret. When one is already saved, leaving this input blank retains it; entering a new value replaces it. |
| Remove saved secret | Explicitly removes the saved secret when saved. Use only when intentionally disconnecting or replacing the configuration. |
| Default theme | Automatic, Light or Dark. Individual CAPTCHA fields can follow or override the default. |
Select Save settings before testing. Merely typing unsaved keys does not change the configuration used by the Verification section.
Verify the saved setup
After both keys are saved, use the widget in Verification, then select Test configuration. Read the result. A rendered widget alone does not establish that server verification works with the secret.
If the widget is missing or verification fails, check that the two keys belong together, the widget permits this hostname, and the browser can load Cloudflare's script. Also check the site's outbound connection to the verification service. Saving the keys again is appropriate only when correcting their values.
Protect an individual form
- Open the form in Build.
- Add CAPTCHA from the field palette.
- Review its label, description, theme and size.
- Save the form and check an embedded page.
Only one CAPTCHA field is allowed in a form. Global credentials alone do not add CAPTCHA to every form. Honeypot protection in General settings is a separate control.
Moving to another environment
Use keys valid for the destination site and perform its saved-configuration test. Cloudflare test keys are accepted by the plugin only in local or development environments; they are rejected in production. They are a development aid rather than protection for a public form.
Changing credentials can affect every form on this site that contains CAPTCHA. After a change, check a representative embedded form as well as the settings-page test.
