Cloudflare Turnstile is a security tool used by websites to confirm that a real person, not a bot, is submitting a form. It works in the background by generating a short-lived, single-use token when a user interacts with a page. This token proves that the request came from a legitimate browser. When the token is missing or invalid, the system shows an error message that says “Turnstile token required.”
How Turnstile Works
- When a page with Turnstile loads, the browser runs a small script.
- The script issues a verification token once basic checks are complete.
- The token is sent along with the form submission to the website’s server.
- The server verifies the token through Cloudflare’s system to confirm it’s valid and recent.
- If the token passes verification, the form or login proceeds normally.
If any step in that process fails, the website won’t accept the submission and will show the “Turnstile token required” message.
Why the Message Appears
There are a few common reasons this error shows up:
- The form was submitted before the Turnstile verification finished.
- The hidden field that carries the token was not included in the form data.
- The token expired because too much time passed before submitting.
- The same token was reused on another submission attempt.
- The server did not perform proper verification of the token.
- A browser extension, content blocker, or caching plugin prevented the Turnstile script from running correctly.
How to Fix It
If You’re a Visitor
- Refresh the page and try again, waiting a moment for the page to fully load.
- Disable ad blockers or privacy extensions that may interfere with Turnstile.
- Avoid using the back button or reusing the same page after a long delay.
- If the issue continues, contact the site owner to let them know.
If You Manage the Website
- Confirm the Turnstile widget loads correctly and displays on all forms.
- Make sure your form includes the hidden input field named
cf-turnstile-response. - Verify that your backend checks the token before accepting the form data.
- Never reuse or cache tokens; each must be new and unique for every submission.
- Keep your site key and secret key set correctly and ensure they match the registered domain.
- Test without extra plugins or aggressive caching to rule out conflicts.
Common Server Errors
You might also see related error codes such as:
- missing-input-response: No token was sent with the form.
- invalid-input-response: The token was corrupted or incomplete.
- timeout-or-duplicate: The token expired or was already used once.
All these indicate that the server did not receive or could not validate a proper Turnstile token.
In Summary
“Turnstile token required” means that your browser or the website failed to send or verify a short-lived proof that you are human. It usually happens because the verification script didn’t complete, the form was cached too long, or the site didn’t properly check the token. Ensuring the page loads fully, tokens are sent correctly, and verification happens on the server will resolve the problem.