OdooWiki OCA HUB

Website reCAPTCHA v2

website_recaptcha_v2 folder_open OCA/website open_in_new
Website License: AGPL-3

This module allows to use reCAPTCHA v2 on website forms.

It is a helper module that only provides the widget and the validation logic which can be used by other modules to actually display it on website forms and check whether the user entry is valid.

This module originally comes from website_recaptcha_reloaded from Tech Receptives, which itself comes from website_recaptcha from Elico Corp.

auto_awesome What this module does

AI-generated from the code · Odoo 17.0

Lets you switch on Google reCAPTCHA v2 protection for website forms by entering your site and secret keys in the Website settings, and provides the widget and validation check that other modules can use.

This is a helper module: it does not add a CAPTCHA to any form by itself, but it gives Odoo the building blocks (the visible widget and the server-side check) that other modules can plug into website forms.

Where it appears: - In Website settings, a new "reCAPTCHA v2" block offers an on/off switch, a Site Key field, a Secret Key field and a link to Google's reCAPTCHA admin page to obtain those keys. - These settings are stored per website, so each website can have its own keys and its own on/off state.

What it does automatically: - When the option is enabled, a ready-made page snippet displays the reCAPTCHA v2 widget using the configured site key and loads Google's reCAPTCHA script. - A validation method checks the visitor's answer by sending the secret key and the visitor's response to Google's verification service (with a 30-second timeout). - If the option is disabled, the check always passes without contacting Google. - If no answer was given, the visitor is rejected with "No response given." - Google error codes (missing or invalid secret, missing or invalid response, bad request, timeout or duplicate) are turned into readable messages, and a generic message is shown for unknown codes or an unsuccessful challenge.

It touches the website configuration and the website settings screen only; the actual forms must be wired up by another module.

Depends on

website
Models and fields (2)
  • website · extends an existing modelrecaptcha_v2_enabled (Enable reCAPTCHA v2), recaptcha_v2_site_key (Site Key (v2)), recaptcha_v2_secret_key (Secret Key (v2))
  • res.config.settings · extends an existing modelrecaptcha_v2_enabled, recaptcha_v2_site_key, recaptcha_v2_secret_key

Text generated by AI (DeepSeek) from reading the Odoo 17.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 17.0

reCAPTCHA is configured in Settings \> Website. It can be enabled or disabled using the checkbox, and the site and secret keys can be defined there when it is enabled.

No verified information in OCA: Installation, Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.