Skip to content


Subversion checkout URL

You can clone with
Download ZIP
SilverStripe module for ReCaptcha spam protection service
PHP Scheme
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Recaptcha FormField Module


Provides a FormField which allows form to validate for non-bot submissions by giving them a challenge to decrypt an image.

Maintainer Contact

  • Ingo Schommer (Nickname: ischommer, chillu)


Developer Documentation


  • Copy the recaptcha directory into your main SilverStripe webroot
  • Run ?flush=1

This should go in your mysite/_config.php. You can get an free API key at

RecaptchaField::$public_api_key = '<publickey>';
RecaptchaField::$private_api_key = '<privatekey>';


As a Standalone Field

If you want to use Recaptcha field by itself, you can simply just include it as a field in your form.

$recaptchaField = new RecaptchaField('MyCaptcha');
$recaptchaField->jsOptions = array('theme' => 'clean'); // optional

See for more configuration options.

Integration with Spamprotection module

This requires the [[:modules:spamprotection|spamprotection module]] to be installed, see its documentation for details. You can use this field to protect any built informs on your website, including user comments in the [[:modules:blog]] module.

Configuration example in mysite/_config.php


Then once you have setup this config you will need to include the spam protector field as per the instructions on the [[modules:spamprotection|spamprotection module]] page.

Known issues:

ReCAPTCHA current does not work if the page doctype is XHTML. The API returns Javascript which uses "document.write", which is not supported in XHTML. A work-around is to always use the no-script version of the module (modify the relevant lines in RecaptchaField.php), or to switch your webpage's doctype to HTML 4. See:

Something went wrong with that request. Please try again.