Cloudflare Docs
Turnstile
Edit this page on GitHub
Set theme to dark (⇧+D)

Turnstile client-side error codes

There are instances where Turnstile may encounter problems, invoking error-callback. Refer to the list of common error codes below for troubleshooting steps to address them.

​​ Error handling

The error-callback option for explicitly rendering widgets and the data-error-callback attribute on implicit rendering provides a JavaScript callback to handle potential errors that occur.

Specifying an error callback is optional. If no error callback is set, Turnstile will throw a JavaScript exception upon error.

If an error callback returns with a non-falsy result, Turnstile will assume that the error callback handled the error accordingly.

If the error callback returns with a no or a falsy result, Turnstile will log a warning to the JavaScript console containing the error code.

An error callback will retrieve an error code as its first parameter.

​​ Retry

By default, Turnstile will automatically retry upon encountering a problem. When subsequent failures due to retries are observed, the error callback can be invoked multiple times.

You can adjust the retry behavior by setting the retry value to never instead of the default auto. This will result in Turnstile not automatically retrying.

An implementation may call turnstile.reset() in the corresponding error-callback to manually trigger a retry.

The interval in between retries of Turnstile can be configured by the retry-interval option.

​​ Interactivity

If the user fails to engage with an interactive challenge within a reasonable timeframe, the timeout callback function is triggered.

For instance, in a scenario where the Turnstile widget is implemented within a lengthy form that may require several minutes to complete, the interactive challenge within the widget becomes outdated if it remains unaddressed for an extended period.

In such instances, the timeout-callback of the widget is activated, enabling the widget to reset itself as needed.

​​ Error codes

An error callback will retrieve an error code as its first parameter. Error codes are separated by the first three numbers into error-code families.

Error code
DescriptionRetryTroubleshooting
crashedA browser process crashed while trying to solve the challenge.YesThe challenge should be retried.
undefined_errorAn unspecific error error occurred with no specific error code associated.YesThe challenge should be retried.
100***Error Code Family Initialization Problems: There was a problem initializing Turnstile before a challenge could be started.NoThis could be caused by an old instance of the challenge that was solved. It is advised to reload the page and restart Turnstile. On continuous failures, this is indicative of an automated device.
102***Error Code Family Invalid Parameters: The visitor sent an invalid parameter as part of the challenge towards Turnstile.YesIt is advised to retry the challenge. On continuous failures, this is indicative of an automated device.
102*** 103*** 104*** 106***Error Code Family Invalid Parameters: The visitor sent an invalid parameter as part of the challenge towards Turnstile.YesIt is advised to retry the challenge. On continuous failures, this is indicative of an automated device and you must verify the visitor’s authenticity by other means.
105***Error Code Family: Turnstile API Compatibility: Turnstile was invoked in a deprecated or invalid way.NoIt is advised to refer to the Turnstile documentation again and refresh the page to obtain the most recent Turnstile version.
110100 110110Invalid sitekeyNoTurnstile was invoked with an invalid sitekey or a sitekey that is no longer active. Verify if the sitekey provided is still active.
110200Domain not allowed.NoTurnstile was used on a domain that was not allowed for this widget to be used on. Ensure that the domain Turnstile is intended to run on is allowed in the widget configuration.
110420This error occurs when an unsupported or incorrectly formatted action is submitted.NoEnsure that the action conforms to the specified structure and contains only valid characters and adheres to the documented length limitations.
110430This error occurs when an unsupported or incorrectly formatted action is submitted. The “Invalid CDATA” error in Turnstile refers to an issue encountered when processing Custom Data (CDATA). This error occurs when the CDATA provided does not adhere to the expected format or contains invalid characters.NoEnsure that the CDATA conforms to the specified structure and contains only valid characters and adheres to the documented length limitations.
110500The visitor is using an unsupported browser.NoEncourage the visitor to upgrade their browser or verify otherwise.
110510The visitor provided an inconsistent user-agent throughout the process of solving Turnstile.NoThe visitor may have browser extensions or settings enabled to spoof their user agent and should disable them to proceed.
11060*The visitor took too long to solve the challenge and the challenge timed out.YesRetry the challenge. The visitor also may have a system clock set to a wrong date.
11062*Visible Mode only: The visitor took too long to solve the interactive challenge and the challenge became outdated.YesReset the widget and re-initialize it to give the visitor the chance to solve the widget again.
120***Error Code Family: Internal Errors for Cloudflare Employees.NoOnly encountered by Cloudflare Support Engineers while debugging.
200010Invalid Caching: Some portion of Turnstile was accidentally cached.NoEncourage the visitor to clear their cache.
200100Time Problem: The visitor’s clock is incorrect.NoEncourage the visitor to set their clock to the correct time.
300***Generic Client Execution Error. An unspecified error occurred in the visitor while they were solving a challenge.YesPotentially Automated Visitor. Retry the challenge. Upon multiple subsequent failures, verify the visitor otherwise.
600***Error Family Challenge Execution Failure: A visitor failed to solve a Turnstile Challenge. Also used by failing testing sitekey.YesPotentially Automated Visitor. Retry the challenge. Upon multiple subsequent failures, verify the visitor otherwise.