Cloudflare Turnstile contact forms

Works with the Simple Cloudflare Turnstile plugin to support usage on a custom contact form.

Shortcode to place the Turnstile within your contact form layout:

add_shortcode( 'ccom_turnstile', function() {

	if( ! function_exists( 'cfturnstile_field_show' ) ) {

	cfturnstile_field_show( '', '', 'ccom_turnstile', mt_rand() );
	return ob_get_clean();

} );

Function to tie into your contact form’s submit action (hook and code depends on which forms plugin or custom code that you use):

add_action( 'contact_form_submit', function() {

	if( ! function_exists( 'cfturnstile_check' ) ) {
		return false;

	if( ! get_option( 'cfturnstile_key' ) ) {
		return false;

	if( empty( $_POST['cf-turnstile-response'] ) ) {
		return false;

	$check = cfturnstile_check();
	$success = $check['success'];
	return $success === true;

} );

How to use

  1. Log into a staging, development, or locally hosted clone of your site
  2. Install and activate Code Snippets
  3. WP Admin > Snippets > Add New
  4. Copy and paste the code from the Description tab above
  5. Check to ensure formatting came over properly and no syntax errors show up in the editor
  6. Customize the code as desired
  7. Add a meaningful title
  8. Select whether to run on front-end or back-end (or both)
  9. Click “Save and Activate”
  10. Test your site to ensure it works
  11. Disable if any problems, or recover
  12. Repeat for live environment


All code snippets are licensed GPLv2 (or later) matching WordPress licensing.

Disclaimer of warranty:

Except when otherwise stated in writing the copyright holders and/or other parties provide the program as-is without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose.


  1. Describe the issue and what you’ve observed.
  2. Describe your expected outcome(s).
  3. List steps to reproduce the issue.
  4. Optionally provide screen-shot or video URLs.