Setting up the Cloudflare Turnstile Add-On

Prerequisites

  • Download and install the add-on.
  • Create a Cloudflare account.
    Cloudflare offers a free account for those planning to use Turnstile. It is not necessary to use Cloudflare’s caching service or have a paid account.

Settings

For a full list of all the Cloudflare Turnstile Add-On settings, refer to this guide.

Create a widget

  1. In the Cloudflare dashboard, go to the Turnstile page.
  2. Select Add widget.
screenshot of the Add Site flow in the Cloudflare Turnstile dashboard
  1. Fill out the required information:
    Widget name: A descriptive name for your widget.
    – Hostname management: Domains where the widget will be used.
    – (Optional) Configure Pre-clearance support for single-page applications.
Image showing Cloudflare Turnstile Widget management
Image showing Cloudflare Turnstile Widget management
Image showing Cloudflare Turnstile Widget Hostname management
Image showing Cloudflare Turnstile Widget Hostname management
  1. Select Create to save your widget.
Image showing Cloudflare Turnstile Widget management
  1. Copy your sitekey and secret key, and store the secret key securely.
Image showing Cloudflare Turnstile Widget management

Adding your Site Key and Site Secret

  1. Go to Forms → Settings → Cloudflare Turnstile.
  2. Copy the Site Key and Secret Key from your Cloudflare dashboard.
  3. Paste both keys into the Turnstile Credentials section.
  4. Under Field Options → Theme, choose your preferred theme (defaults to Auto).
  5. Click Save Settings to apply your changes. Turnstile is now ready to use in your forms.
Image showing Gravity Forms Turnstile Add-On settings page.

Additional Settings

The full guide to the Cloudflare Turnstile Add-on Settings Reference provides an in-depth explanation of the additional configuration settings for the add-on.