diff --git a/src/content/docs/turnstile/troubleshooting/challenge-solve-issues.mdx b/src/content/docs/turnstile/troubleshooting/challenge-solve-issues.mdx index ccaed27fd0bd189..1f8cc724ffbd1c7 100644 --- a/src/content/docs/turnstile/troubleshooting/challenge-solve-issues.mdx +++ b/src/content/docs/turnstile/troubleshooting/challenge-solve-issues.mdx @@ -8,6 +8,28 @@ sidebar: import { Render } from "~/components" -If you encounter issues when solving a challenge, try the following: +## Challenge loops + +You may encounter a challenge loop where the challenge keeps reappearing without being solved. This can happen for several reasons: + +- **Network issues**: Poor or unstable network connections can prevent the challenge from being completed. +- **Browser configuration**: Some browser settings or extensions may block the scripts needed to execute the challenge. +- **Unsupported browsers**: Using a browser that is not supported by Turnstile. +- **JavaScript disabled**: Turnstile relies on JavaScript to function properly. +- **Detection errors**: If Turnstile suspects bot-like behavior, you may encounter repeated challenges for verification. + +Most challenges are quick and should take only a few seconds to complete. If it takes longer, ensure your network is stable and follow the [troubleshooting steps](#troubleshooting). + +:::note +If the issue persists, try switching to a different network or device to rule out any issues with your browser environment. + +Make sure that your browser is updated to the latest version. +::: + +## Troubleshooting + +Follow the steps below to ensure that your environment is properly configured. + +If none of the above resolves your issue, contact the website administrator with the [error code](/turnstile/troubleshooting/client-side-errors/error-codes/) and Ray ID or submit a [feedback report](/turnstile/troubleshooting/feedback-reports/) through the Turnstile widget by selecting **Submit Feedback**. \ No newline at end of file diff --git a/src/content/docs/turnstile/troubleshooting/client-side-errors/error-codes.mdx b/src/content/docs/turnstile/troubleshooting/client-side-errors/error-codes.mdx index 18ca68ef63c1131..ec5e3b32b12e395 100644 --- a/src/content/docs/turnstile/troubleshooting/client-side-errors/error-codes.mdx +++ b/src/content/docs/turnstile/troubleshooting/client-side-errors/error-codes.mdx @@ -37,7 +37,7 @@ When an error code is marked with `***`, it means that the remaining numbers can ## Error code `300***` and `600***` -Error code family `300***` and `600***` (e.g. "`600010`: The generic_challenge_failure") is a response generated by the Turnstile in situations where a potential bot or unusual visitor behavior is detected. +Error code family `300***` and `600***` (e.g. "`600010: The generic_challenge_failure`") is a response generated by the Turnstile in situations where a potential bot or unusual visitor behavior is detected. You can troubleshoot these error codes using the following recommendations: diff --git a/src/content/partials/turnstile/troubleshooting-steps.mdx b/src/content/partials/turnstile/troubleshooting-steps.mdx index f9d853b0e9389a2..1148e5e231986cd 100644 --- a/src/content/partials/turnstile/troubleshooting-steps.mdx +++ b/src/content/partials/turnstile/troubleshooting-steps.mdx @@ -3,19 +3,19 @@ --- -- Verify your browser compatibility: Ensure that the browser you are using is one of the supported browsers for Turnstile and the browser is up to date. Refer to [supported browsers](/waf/reference/cloudflare-challenges/#browser-support) for more information. - - Cloudflare challenges support all major browsers except Internet Explorer. -- Clear your browser cache and cookies: Refer to the guides below on how to clear your browser cache and cookies based on your preferred browser. - - [Google Chrome](https://support.google.com/accounts/answer/32050?hl=en\&co=GENIE.Platform%3DDesktop) - - [Mozilla Firefox](https://support.mozilla.org/kb/clear-cookies-and-site-data-firefox) - - Safari - - [Desktop](https://support.apple.com/guide/safari/manage-cookies-sfri11471/mac) - - [Mobile](https://support.apple.com/105082) - - [Microsoft Edge](https://support.microsoft.com/windows/manage-cookies-in-microsoft-edge-view-allow-block-delete-and-use-168dab11-0753-043d-7c16-ede5947fc64d) -- Disable all browser extensions: Browser extensions may hinder the challenge from being successfully executed. To resolve this issue, disable your extensions and reload the page. -- Ensure that JavaScript is enabled. -- Confirm that cookies are enabled. -- Try again in incognito or private mode. -- Test with another browser or device. -- Ensure that you are not behind a VPN or proxy. -- Try from a different network. +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](/waf/reference/cloudflare-challenges/#supported-browsers). +2. Disable your browser extensions. + - Some browser extensions, such as ad blockers or privacy tools, 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 by masking your real IP address or modifying request headers. 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. \ No newline at end of file