{"id":226,"date":"2026-11-19T09:30:24","date_gmt":"2026-11-19T09:30:24","guid":{"rendered":"https:\/\/oddlylogical.com\/logical-forms\/?post_type=doc&#038;p=226"},"modified":"2026-11-19T09:30:24","modified_gmt":"2026-11-19T09:30:24","slug":"troubleshoot-captcha","status":"publish","type":"doc","link":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/","title":{"rendered":"Troubleshoot CAPTCHA verification"},"content":{"rendered":"<p>Logical Forms uses Cloudflare Turnstile. The widget's appearance and successful server verification are separate checks. Start with the exact error and whether the widget loads, becomes ready, expires or fails only after Submit.<\/p>\n<h2 id=\"configuration\">Verify site configuration<\/h2>\n<ol>\n<li>Open <a href=\"https:\/\/oddlylogical.com\/logical-forms\/docs\/captcha-settings\/\">Logical Forms \u2192 Settings \u2192 Captcha<\/a>. Confirm the intended provider, Site key and saved Secret key.<\/li>\n<li>Check that both credentials belong to the intended Turnstile widget and its allowed hostname includes the site's current domain. A staging or mapped domain may differ from the original site.<\/li>\n<li>Save and use the configuration test. Do not expose the Secret key in screenshots or browser code.<\/li>\n<li>Open a fresh saved public form and complete a controlled test. A connection or widget test alone does not prove final submission verification.<\/li>\n<\/ol>\n<p>Official test credentials are accepted only when WordPress identifies the environment as local or development. Staging or production environment labels do not enable that exception. Use real credentials for the actual public host.<\/p>\n<h2 id=\"placement\">Check form placement<\/h2>\n<p>Use one <a href=\"https:\/\/oddlylogical.com\/logical-forms\/docs\/captcha-field\/\">CAPTCHA field<\/a> on the final page. The field, final page and containing Section must be unconditional. A branch that can skip the challenge is not a valid configuration. CAPTCHA cannot be inside a Repeater.<\/p>\n<h2 id=\"scripts\">The widget does not load or complete<\/h2>\n<p>Inspect the browser console and network failures for blocked Turnstile scripts, content-policy restrictions or network errors. Compare a fresh private window and the actual embedded page with saved Preview. Browser extensions and script optimization can affect the widget; reproduce a suspected conflict on staging.<\/p>\n<p>The server must also reach the verification service. A host HTTP restriction or timeout can prevent verification even when the browser widget looks complete. Ask the host to inspect the failed outbound verification request without logging the secret or response token.<\/p>\n<h2 id=\"retry\">Expired or invalid attempts<\/h2>\n<p>Complete the refreshed widget and retry within a fresh page attempt. Do not copy verification tokens between forms, domains or attempts. The plugin checks the provider result, hostname and form action; changing only the visible checkmark does not satisfy those checks.<\/p>\n<p>Repeated verification failures can exhaust the attempt's bounded verification allowance. Reload a fresh form and investigate the underlying cause instead of bypassing verification or continually resubmitting an old token.<\/p>\n<h2 id=\"support\">Evidence for support<\/h2>\n<p>Record the page URL, form ID, current hostname, timestamp, environment type, visible error and whether failure occurs before or after Submit. Include sanitized console\/request errors, plus Core\/add-on versions. Never include the Secret key, browser cookies or a live verification token.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.<\/p>\n","protected":false},"author":1,"featured_media":0,"menu_order":320,"template":"","doc-categories":[18],"class_list":["post-226","doc","type-doc","status-publish","hentry","doc_category-troubleshooting"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Troubleshoot CAPTCHA verification | Logical Forms Docs<\/title>\n<meta name=\"description\" content=\"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Troubleshoot CAPTCHA verification | Logical Forms Docs\" \/>\n<meta property=\"og:description\" content=\"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/\" \/>\n<meta property=\"og:site_name\" content=\"Logical Forms\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/troubleshoot-captcha\\\/\",\"url\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/troubleshoot-captcha\\\/\",\"name\":\"Troubleshoot CAPTCHA verification | Logical Forms Docs\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/#website\"},\"datePublished\":\"2026-11-19T09:30:24+00:00\",\"description\":\"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/troubleshoot-captcha\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/troubleshoot-captcha\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/troubleshoot-captcha\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/home\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Troubleshoot CAPTCHA verification\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/#website\",\"url\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/\",\"name\":\"Logical Forms\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/oddlylogical.com\\\/logical-forms\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Troubleshoot CAPTCHA verification | Logical Forms Docs","description":"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/","og_locale":"en_US","og_type":"article","og_title":"Troubleshoot CAPTCHA verification | Logical Forms Docs","og_description":"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.","og_url":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/","og_site_name":"Logical Forms","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/","url":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/","name":"Troubleshoot CAPTCHA verification | Logical Forms Docs","isPartOf":{"@id":"https:\/\/oddlylogical.com\/logical-forms\/#website"},"datePublished":"2026-11-19T09:30:24+00:00","description":"Check Logical Forms Turnstile credentials, allowed hostnames, challenge placement and blocked scripts when CAPTCHA verification fails.","breadcrumb":{"@id":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/oddlylogical.com\/logical-forms\/docs\/troubleshoot-captcha\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/oddlylogical.com\/logical-forms\/home\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/oddlylogical.com\/logical-forms\/docs\/"},{"@type":"ListItem","position":3,"name":"Troubleshoot CAPTCHA verification"}]},{"@type":"WebSite","@id":"https:\/\/oddlylogical.com\/logical-forms\/#website","url":"https:\/\/oddlylogical.com\/logical-forms\/","name":"Logical Forms","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/oddlylogical.com\/logical-forms\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/docs\/226","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/types\/doc"}],"author":[{"embeddable":true,"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/docs\/226\/revisions"}],"predecessor-version":[{"id":227,"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/docs\/226\/revisions\/227"}],"wp:attachment":[{"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/media?parent=226"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/oddlylogical.com\/logical-forms\/wp-json\/wp\/v2\/doc-categories?post=226"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}