Troubleshooting Guide

Widget does not appear

Check:

1. Addon is activated in WHMCS.
2. Enable Turnstile is On.
3. The specific page toggle is On.
4. Site Key is filled.
5. Template cache is cleared.

Verification always fails

Check:

1. Secret Key is correct.
2. Cloudflare Turnstile hostname matches your WHMCS domain.
3. Server can reach Cloudflare over HTTPS.

Works on some pages but not others

Check:

1. Correct form toggles are enabled.
2. You are testing while logged out (if Skip Logged-In Users is On).
3. Your template is Twenty-One, Nexus, or a child template based on them.
4. If your template is heavily customized, placement selectors may need small adjustments.

Unexpected redirect after failure

• Redirect is intentionally restricted to your WHMCS origin for safety.
• Invalid external referers are ignored and user is sent to homepage.

Language is not changing

• Keep Default Language as auto.
• Confirm WHMCS client language is set.
• Confirm matching language file exists in modules/addons/turnstile/lang/.