Developer's Guide
Stay organized with collections
Save and categorize content based on your preferences.
Important: Version 1.0 of the reCAPTCHA API is no longer supported, please upgrade to Version 2.0. Learn more
Welcome to the developer documentation for reCAPTCHA! reCAPTCHA lets you embed a
CAPTCHA in your web pages in order to protect them against spam
and other types of automated abuse. Here, we explain how to add reCAPTCHA to your page.
Audience
This documentation is designed for people familiar with HTML forms and server-side processing.
To install reCAPTCHA, you will probably need to edit some code.
We hope you find this documentation easy to follow. Make sure to join the
reCAPTCHA developer forum to give
feedback and discuss the API.
Overview
API Keys
To use reCAPTCHA, you need to
sign up for API keys
for your site. The keys are unique to the domain or domains you specify, and
their respective sub-domains. Specifying more than one domain could come in handy
in the case that you serve your website from multiple top level domains (for
example: yoursite.com, yoursite.net).
By default, all keys work on "localhost" (or "127.0.0.1"), so you can always
develop and test on your local machine.
Integration
Once you've signed up for API keys, you can add reCAPTCHA to your site and customize the widget. If you're using one of the following programming environments or applications, click on the link below for further instructions.
Programming Environments:
PHP
ASP.NET
Classic ASP (contributed by Mark Short)
Java/JSP
Perl
Python
Ruby (contributed by McClain Looney)
Another Ruby library from Jason L Perry
Ruby/Rack (contributed by Arthur Chiu)
JSP Mailhide Tag (contributed by Tamas Magyar)
ColdFusion (contributed by Robin Hilliard)
WebDNA (contributed by Dan Strong)
Applications:
MediaWiki
phpBB
FormMail
Movable Type (contributed by Josh Carter)
Drupal (contributed by Rob Loach)
Symfony (contributed by Arthur Koziel)
TYPO3 (maintained by Markus Blaschke, contributed by Jens Mittag. See also the example of using the plugin)
NucleusCMS (contributed by Matt)
vBulletin (contributed by Magnus)
Joomla (contributed by Mark Fabrizio)
Joomla Community Builder (contributed by Ayan Debnath)
JSP Mailhide (contributed by Tamas Magyar)
bbPress (contributed by Rhys Wynne)
ExpressionEngine (contributed by Jaspaul Aggarwal)
FlatPress (contributed by Ross Fruen)
PHPKIT (contributed by Norman Huth)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["reCAPTCHA protects your web pages from spam and automated abuse by embedding a CAPTCHA."],["Developers need to sign up for API keys unique to their website's domain to utilize reCAPTCHA."],["Version 1.0 of the reCAPTCHA API is no longer supported; users should upgrade to Version 2.0."],["reCAPTCHA offers customization options and integration with various programming environments and applications."],["Developers can access support and engage with the community through the reCAPTCHA developer forum."]]],["reCAPTCHA, designed to protect web pages from spam, requires users to sign up for API keys specific to their domains. After obtaining keys, users can integrate reCAPTCHA into their sites and customize the widget. Version 1.0 is no longer supported and users should upgrade to 2.0. The documentation provides instructions for various programming environments like PHP, and applications such as MediaWiki, offering tailored guidance for each.\n"]]
