# Captcha

{% hint style="info" %}
The availability of functionality depends on the license and may not be available in all deployments.
{% endhint %}

The captcha component is a Google widget whose purpose is to allow only data submitted by a human to be sent.

![](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/5XIDttualUtt5dKz32NV/Captcha_files/image2025-5-15_15-54-3.png)

## Component properties

The component can be placed on the form multiple times, and its display can be made conditional on a requirement being met.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2F9nKGbLFkTskXoe6eQzma%2Fimage2016-9-19%2012_59_8.png?alt=media&#x26;token=1b0c8952-daeb-4ffc-9729-16dfb36315b4" alt=""><figcaption><p align="center"><em><strong>Illustration 1.</strong> Captcha component displayed on the form</em></p></figcaption></figure>

Entering the value of the captcha placed on the form is always required - verification will be positive when the "I'm not a robot" checkbox is selected and, optionally, other actions are performed (imposed by Google).

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FLTDUFAwufh7eY7wWFl87%2Fimage.png?alt=media&#x26;token=beeb7c67-5af7-413c-b451-809fd4cb7b7a" alt=""><figcaption><p align="center"><em><strong>Figure 2.</strong></em> <em>In the example, the "I'm not a robot" checkbox was not selected, which caused a validation error message to be displayed</em></p></figcaption></figure>

Component validation occurs after the image is correctly selected. The component stores 3 types of states: too long waiting time after verification - "expired", positive verification - "ok" or negative - "noOk". Interactions on the form may depend on the state of the component.

<figure><img src="https://2112972046-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2FQtUGPOXqd2MUu04lkWcp%2Fimage2016-9-20%208_0_3.png?alt=media&#x26;token=db3c5792-4b5c-483e-9e91-5c6d76a31b2e" alt=""><figcaption><p align="center"><em><strong>Figure 3.</strong></em> <em>Message after successful verification</em></p></figcaption></figure>

## Registration

To be able to use the component on the form, you need to register a domain and a pair of keys with Google. More on this topic can be found on the page [Google](https://developers.google.com/recaptcha).

{% hint style="info" %}
Demo form: demo2\_recaptcha
{% endhint %}
