Skip to main content

ReCaptcha widget for Plone.

Project description


plone.formwidget.recaptcha is a z3c.form ReCaptcha widget for use with Plone.

It is a z3c.form re-implementation of the collective.recaptcha package original written by David Glick.

Buildout Installation

Add the following code to your buildout.cfg to install plone.formwidget.recaptcha:


eggs =

ReCaptcha setup

There is a control panel at http://path/to/site/@@recaptcha-settings to configure the Addon. Google provides a set of test keys, that can be used to try out the recaptcha form and documentation at


Secret key: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

To actually use the service, you must obtain a site key and secret key from


See the demo folder inside the distribution for an example usage.


You can add a captcha field in an XML model by adding something like this:

<field name="captcha" type="plone.formwidget.recaptcha.ReCaptchaWidget">
  <title>Solve Captcha</title>

Upgrade to API v2

plone.formwidget.recaptcha 2.* uses V2 of the reCaptcha API. Users upgrading from plone.formwidget.recaptcha 1.* will therefore need to generate new keys as global Keys are not supported in the V2 API.

Source Code

Contributors please read the document Process for Plone core’s development

Sources are at the Plone code repository hosted at Github.


2.3.0 (2021-03-01)

New features:

  • Provide a field to be used from an XML model [frapell] (#24)

  • Subsite support (i.e. collective.lineage) [jensens] (#28)

Bug fixes:

  • Format code according to Plone standards: black, isort, zpretty. (#27)

  • Move CI from TravisCI to Github Actions [jensens] (#29)

2.2.0 (2019-07-10)

New features:

  • Python 3 compatibility [staeff, petschki] (#19)

2.1.0 (2019-02-20)

  • Update TravisCI Setup and test with Plone 5.1 and 5.2 on Python 2.7. Also test on Python 3.6+3.7 (allowed to fail, and fails for now). [jensens]

  • Remove obsolete action icons configuration. [thet]

  • update controlpanel text [lucid-0]

  • Remove obsolete recaptcha_ajax.js - all scripts are integrated via the norecaptcha package. Add upgrade step for that. [thet]

2.0.0 (2018-09-05)

  • Add a dummy widget display view which renders empty. A widget needs a display view, otherwise form result rendering may fail. [thet]

2.0a3 (2016-12-21)

2.0a2 (2015-06-17)

  • Fix: problem with and old package structure made 2.0a1 a brown bag release. All non-python files (i.e. zcml) were missing. [jensens]

2.0a1 (2015-06-17)

  • some pep8/plone conventions code style cleanup. [jensens]

  • recaptcha API 2 (aka norecaptcha) [mamico]

1.0b3 - 2010-11-18

  • Register browser components for a product browser layer so they don’t leak to sites without this product installed. Run the upgrade step if upgrading on a site that already has this product installed. [davisagli]

  • Move to feature declaration to meta.zcml. [timo]

  • Adapt recaptcha view instead of captcha view for validation. [ramon]

1.0b2 - 2010-06-02

  • Updated package metadata and marked this as a Plone add-on. [timo]

  • Declare that plone.formwidget.captcha provides a Captcha field that can be used by to add a Captcha field to comment forms. [timo]

1.0b1 - 2009-12-07

  • z3c.autoinclude.plugin added [timo]

1.0a1 - 2009-08-28

  • Initial release [timo]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plone.formwidget.recaptcha-2.3.0.tar.gz (22.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page