Issue
- How can users enable audio for CAPTCHA verification?
Environment
- Liferay DXP 7.4+
Resolution
- Liferay does not provide out-of-the-box (OOTB) support for audio CAPTCHA functionality. However, you can use Google reCAPTCHA, which offers an audio challenge:
- Integrate Google reCAPTCHA: Google reCAPTCHA includes an audio CAPTCHA option and is available as a CAPTCHA engine in Liferay. ReCAPTCHA v2, in particular, does not require any additional property configurations. To integrate Google reCAPTCHA with Liferay, follow these steps:
- Step 1: Obtain reCAPTCHA Keys
- Visit www.google.com/recaptcha in your web browser.
- Go to Google's “Admin console,” located in the top-right corner when this article was published.
- Fill in the required details for your site and click “Submit”.
- After registration, Google provides you with a Site Key and a Secret Key.
- Step 2: Configure reCAPTCHA in Liferay (see official Liferay CAPTCHA documentation)
- Log in to your Liferay instance as an admin user.
- Navigate to:
- 2025.Q2+: Control Panel → Configuration → Instance Settings → Security Tools → CAPTCHA
- Earlier Versions: Control Panel → Configuration → System Settings → Security Tools → CAPTCHA
- Set reCAPTCHA in the CAPTCHA Engine drop-down.
- Enter the Site Key in the “reCAPTCHA Public Key” field.
- Enter the Secret Key in the “reCAPTCHA Private Key” field.
- Click Save to apply the changes.
- Step 3: Verify Integration
- Log out of Liferay.
Go to the Create Account page.
Users should now see the Google reCAPTCHA interface, which includes an audio CAPTCHA option.
- Step 1: Obtain reCAPTCHA Keys
Additional Information
- Using a CAPTCHA Client Extension
- In case any errors have been observed related to an "Invalid site key" error, kindly refer to Error-Invalid-site-key-when-using-reCAPTCHA-v3 and Regarding-compatibility-with-reCAPTCHA-V3
- Third-party: Integrating Captcha
- Third-party: Using Captcha/reCAPTCHA with Custom Portlets