How do I add reCAPTCHA to a webform?

Last Updated: 6/4/2025     Tags: recaptcha, form, webpage, reCaptcha, page
  • Switch Version
  • V5
  • V4

Users can add a reCAPTCHA block to webforms built in Taguchi to validate the entry of submissions. ReCAPTCHA is a security service provided by Google, designed to prevent fraud attacks on websites and mobile apps.

There are several steps for a user to add a reCAPTCHA block to a form built in Taguchi.

  1. Setting up a reCAPTCHA service in Google
  2. Adding the reCAPTCHA secret key in Taguchi
  3. Adding a reCAPTCHA block to your webform
  4. Testing the reCAPTCHA functionality

1. Setting up a reCAPTCHA service in Google

reCAPTCHA is a Google service that first needs to be configured in a Google reCAPTCHA account.

You will need to have access to your own Google Cloud Platform account to generate reCAPTCHA keys.

During your set up, you will receive a public and secret key, both which need to be entered into Taguchi.

  1. Register your site in Google reCAPTCHA

Register your site in Google reCAPTCHA

  • Taguchi supports reCAPTCHA v2, so please select this during the set up.
  • *In the ‘Domains’ section, in addition to adding domains you want the reCAPTCHA to appear, you must add the click-tracking domain configured in your Taguchi organisation to utilise Taguchi’s reCAPTCHA block in your form. The click-tracking domain can be found in the ‘Domains’ section under the Settings tab within Taguchi.

Site and Secret keys

After registration, you’ll be taken to a page where you'll see two keys:

  • Site key: Used in the frontend (HTML of your site). This key will need to be added into the reCAPTCHA block of your webform activity
  • Secret key: Used in the backend (server-side verification). This key will need to be added into the webform integration.

Site and secret keys

2. Adding the reCAPTCHA secret key in Taguchi

All webforms in Taguchi are set up with a V5 endpoint integration.html). Integrations can be set up via the Settings menu in the 'Integration' section.

Form integration

While setting up your webform integration, select API: V5 endpoint integration.html) under Details > Type. Link to v5 endpoint page.

Forms api

In the configuration section, you will be able to select what functionality you would like for your form.

To include reCAPTCHA, complete the following:

  1. Select the Require reCAPTCHA checkbox
  2. Enter your reCAPTCHA secret key in the 'reCAPTCHA secret key' text field.

This is all that’s required to enable reCAPTCHA in your form. Select the remaining configuration options which apply to your webform and select activate.

A secret key is like a password. Please don’t share your secret key with Taguchi staff.

3. Adding a reCAPTCHA block to your webform

In your webform, add reCAPTCHA by using the Taguchi standard reCAPTCHA content block.

  1. Drag and drop the block into your form.

Form integration

  1. Once added, add your Site key (from Google) in the ‘Site Key’ field of the block.

Recaptcha block

4. Testing reCAPTCHA functionality

Once everything is set up, we suggest you follow this process to test the reCAPTCHA.

  1. Complete the form: Go to the form where the reCAPTCHA block has been added.
  2. Submit the form: Enter the necessary details and attempt to submit the form.
  3. Verify reCAPTCHA: Ensure that the reCAPTCHA prompt appears and works as expected (e.g., selecting images, checkbox, or solving puzzles).
  4. Confirm submission: After passing the reCAPTCHA verification, check that the form submission is recorded correctly in your organisations database.
  5. Test multiple scenarios: Test under different conditions, such as:
  6. Submitting without completing the reCAPTCHA to ensure the form is blocked.
  7. Testing on multiple devices or browsers for consistency.
  8. Review submissions: Ensure that only legitimate submissions (after reCAPTCHA validation) are being recorded.

By thoroughly testing, you’ll confirm the reCAPTCHA is functioning properly and preventing unwanted submissions.