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.
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.
To use reCAPTCHA, you need to sign up for API keys for your site. Unless you select the "global key" option, the keys are unique to your domain and sub-domains. (By default, all keys work on "localhost" (or "127.0.0.1"), so you can always develop and test on your local machine.)
Once you've signed up for API keys, adding reCAPTCHA to your site consists of two steps and optionally a third step where you customize the widget:
- Client Side: Displaying the reCAPTCHA Widget (Required)
- Server Side: Verifying the solution (Required)
- Customizations (Optional)
In most Web forms, you usually have two files: the form itself with the fields, and the file with the script to process the inputs to the form. These two files correspond to steps 1 and 2 above. Therefore, in most cases you will have to modify two different files.
There are two ways to add reCAPTCHA to your site: (a) using a "plugin," or (b) writing code to communicate with our servers. We have plugins for most common applications and programming environments, and if there is one that fits your needs, we strongly encourage you to use it. If you're using one of the following programming environments or applications, click on the link below for specific instructions or plugins. Otherwise, proceed to our pages on displaying reCAPTCHA without a plugin and verifying the user's answer without a plugin.