Error codes

Note

When an error code is marked with ***, it means that the remaining numbers can be ignored and are for internal use.

Error Code	Description	Retry	Troubleshooting
100010	Widget initialization failed	No	Reload page. If persistent, it indicates an automated device.
100020	Multiple initialization attempts	No	Clear the existing widget before creating new one.
100030	Invalid widget state	No	Reset widget with turnstile.reset().
102010	Invalid challenge response	Yes	Retry the challenge.
102020	Network timeout during challenge	Yes	Check internet connection and retry.
102030	Corrupted challenge data	Yes	Clear browser cache and retry.
103010	Browser compatibility issue	Yes	Refer to supported browsers.
103020	JavaScript execution error	Yes	Ensure JavaScript is enabled.
103030	Browser extension interference	Yes	Disable extensions temporarily.
104010	Invalid widget configuration	Yes	Check widget parameters.
104020	Missing required parameters	Yes	Ensure all required options are provided.
104030	Parameter type mismatch	Yes	Verify parameter data types.
105010	Deprecated API method	No	Update to the current API version.
105020	Invalid API configuration	No	Review client-side configurations.
105030	Unsupported feature usage	No	Check feature availability.
106010	Generic parameter error	Yes	Review all widget parameters.
106020	Parameter validation failed	Yes	Check parameter format and values.
110100	Invalid sitekey	No	Verify the sitekey in Cloudflare dashboard ↗.
110110	Sitekey not found	No	Check sitekey spelling and dashboard configuration.
110200	Domain not authorized	No	Add current domain in Hostname Management
110420	Rate limiting active	No	Wait before retrying, review rate limits
110430	Account suspended	No	Contact Cloudflare support.
110500	Browser not supported	No	Refer to supported browsers.
110510	Feature not available	No	Check your account plan and feature availability.
120010	Script loading failed	Yes	Check your internet connection and content blockers.
120020	Resource timeout	Yes	Retry after checking network stability
120030	CDN unavailable	Yes	Wait and retry. Check your firewall settings
200010	Widget already rendered	No	Reset existing widget before re-rendering.
200100	Widget not found	No	Ensure the container element exists.
200500	Widget state error	Yes	Reset widget with turnstile.reset().
300*	Generic challenge failure	No	Bot behavior detected. Refer to troubleshooting.
400020	Invalid widget size	No	Use valid size: normal, compact.
400030	Invalid appearance	No	Use valid appearance: always, execute, interaction-only.
400040	Invalid theme	No	Use valid theme: light, dark, auto.
600*	Generic challenge failure	No	Bot behavior detected. Refer to troubleshooting.

Error families

Family	Category	Cause
100***	Initialization problems	Page reload needed.
102***	Invalid parameters (network)	Network or browser issues.
103***	Invalid parameters (browser)	Browser compatibility issues.
104***	Invalid parameters (client-side)	Client validation failures.
105***	API compatibility	Implementation error.
106***	Invalid parameters (general)	Parameter validation failures.
110***	Configuration issues	Setup problems.
120***	Network or loading issues	Connection problems.
200***	Widget issues	Widget state problems.
300***	Generic Challenge failure	Bot detection.
400***	Client configuration	Invalid options.
600***	Generic Challenge failure	Bot detection.

---

Troubleshooting

You can troubleshoot these error codes using the following recommendations:

1. Verify your browser compatibility.
   • Turnstile supports all major browsers, except Internet Explorer.
   • Ensure your browser is up to date. For more information, refer to our Supported browsers.
2. Disable your browser extensions.
   • Some browser extensions, such as ad blockers, may block the scripts Turnstile needs to operate.
   • Temporarily disable all extensions and reload the page.
3. Enable JavaScript.
   • Turnstile requires JavaScript to run. Ensure it is enabled in your browser settings. Refer to your browser's documentation for instructions on enabling JavaScript.
4. Try Incognito or Private mode.
   • Use your browser's incognito or private mode to rule out issues caused by extensions or cached data.
5. Test another browser or device.
   • Switch to a different browser or device to see if the issue is specific to your current setup.
6. Avoid VPNs or proxies.
   • Some virtual private networks (VPN) or proxies may interfere with Turnstile. Disable them temporarily to test.
7. Switch to a different network.
   • Your current network may have restrictions causing Turnstile challenges to fail. Try switching to another network, such as a mobile hotspot.

Error code 401

Turnstile may occasionally generate a 401 Unauthorized error in your browser console during a security check. This is not typically a problem with your implementation. This error often occurs when the widget attempts to request a Private Access Token that your device or browser does not support yet.

You can generally safely ignore the 401 error, as it is an expected part of Turnstile's underlying Challenge Platform workflow. If the widget is successfully resolving and you are receiving a token, no action is required.