How to Enable Google's reCAPTCHA in Joomla — Step‑by‑Step

Introduction

Captcha’s are parts of a website where you sometimes need to type in a word or recognize the images to prove you're a human. Captchas are a great way to prevent spam activity on your website because most "bots" that attempt to post spam cannot read the letters contained in the captcha image.

For years, using Captcha sites prompted users to confirm they aren’t robots by asking them to read distorted text and type it into a box.

But Google released a new API that simplifies the reCAPTCHA experience by just directly asking the users whether or not they are robots. They called it "No CAPTCHA reCAPTCHA". This is how it looks:

In this article we're going to walk you through the steps for enabling CAPTCHA / reCAPTCHA (Google) in Joomla.

Prerequisites

• A Joomla administrator account with access to Extensions > Plugin Manager and System > Global Configuration.
• A Google account to create reCAPTCHA keys (Site key and Secret key).

Obtain your reCAPTCHA keys

1. Sign in with your Google account at the Google reCAPTCHA admin panel and register your site to obtain Site and Secret keys:

Create a reCAPTCHA key: https://www.google.com/recaptcha/admin#list

2. When registering, add your website domain and choose the appropriate reCAPTCHA type (the article refers to the No CAPTCHA checkbox flow; Google now offers v2/v3 and Invisible reCAPTCHA — confirm the current choice in Google's admin).

Step-by-step: Enable reCAPTCHA in Joomla

1. Log in to your Joomla administrator back-end.

2. Go to Extensions > Plugin Manager (or find Plugin Manager from the Control Panel).

3. Edit the "Captcha - ReCaptcha" plugin.

a) Set Status to "Enabled".

b) Copy and paste the Site Key and Secret Key from the Google reCAPTCHA admin into their appropriate fields in the plugin settings.

• You will get the Site and Secret keys by signing in with your Google account here: https://www.google.com/recaptcha/admin#list
• Once you have registered your website domain, Google will provide your reCAPTCHA keys.

c) Click Save & Close.

Configure Global settings (Contact forms and Registration)

4. To enable reCAPTCHA for Contact forms and Registration:

a) Go to System > Global Configuration and select the "Site" tab.

b) In the Default Captcha field choose "Captcha - ReCaptcha".

c) Click Save & Close.

Configure Registration form-specific behavior

5. To control reCAPTCHA behavior specifically for user registration (if you need different behavior from the Global Configuration):

a) Go to Users > User Manager.

b) Click "Options" and open the Component tab.

c) In the Component tab choose one of the Captcha options:

• Use Default — follows the Default Captcha setting in Global Configuration.
• None Selected — ignores the Default Captcha; use this if you want reCAPTCHA in Contact forms but not in Registration.
• Captcha - ReCaptcha — forces reCAPTCHA for registration even if Global Configuration is set to None.

Click Save & Close.

Troubleshooting and verification

• Verify the Site and Secret keys are correct and correspond to the registered domain in the Google admin panel.
• Clear Joomla cache and browser cache after saving plugin/global settings.
• If reCAPTCHA does not appear, confirm the Captcha plugin is "Enabled" in Plugin Manager and that another extension is not conflicting.
• Test your Contact form and the Registration form to ensure the reCAPTCHA widget displays and submission succeeds.

Notes

• The article refers to Google's "No CAPTCHA reCAPTCHA" (checkbox flow). Google offers multiple reCAPTCHA variants (v2 checkbox, Invisible reCAPTCHA, and v3). Confirm the reCAPTCHA type you registered in the Google admin panel before copying keys.

• Official Google reCAPTCHA admin: https://www.google.com/recaptcha/admin#list

That's it!