
Troubleshooting
Fixes for the most common issues: captcha not appearing, caching conflicts, cooldowns, and the JoomLa 4.4 fatal.
The captcha doesn't appear at all. Check, in order: the plugin is enabled (see Enabling the Plugin); the component or Global Configuration actually selects SimpleMath Captcha as the default (see Turning It On For a Form); the form field itself carries type="captcha".
Every answer is rejected as "already been used". Almost always page caching (see Caching) — a cached page hands the same challenge ID to every visitor, and the ID only lives in the first visitor's session. Confirm the page isn't sitting behind an external cache (a reverse proxy or CDN) that Joomla's own allowCache(false) can't reach.
Answers keep getting rejected right after a correct one. That's the cooldown left over from earlier wrong answers, still counting down. Lower First delay, or switch Progressive delay off (see Security Settings).
The refresh button does nothing, or isn't there at all. It's hidden entirely until the bundled script has run — see Working Without JavaScript. Confirm media/plg_captcha_simplemathcaptcha/js/simplemathcaptcha.js is actually being served, and that no template is stripping Joomla's Web Asset Manager output.
Answers with spelled-out numbers are rejected. Turn Accept spelled out answers on (see Challenge Settings), and confirm the PLG_CAPTCHA_SIMPLEMATHCAPTCHA_NUMBER_* strings are actually translated for your site's active language — see the accent-folding note in the Languages article if the language is German, Spanish, or French specifically.
The sum is too hard for your visitors. Use the Easy difficulty, or Custom with only addition and a narrow range like 1–10. A captcha a real person can't reliably pass isn't security, it's just friction.
Everything installed and rendered fine on Joomla 5/6, but the whole page 500s on Joomla 4.4 specifically. This exact scenario was hit and fixed during this plugin's own development — the underlying cause was the shared provider class referencing an interface that only exists on Joomla 5+. If you're running a build older than the one this documentation ships with, update the plugin; a current build already includes the fix and has been verified end-to-end on a real Joomla 4.4.8 installation.