> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.unicornplatform.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to activate reCAPTCHA

In this guide, you will learn how to add reCAPTCHA to your Unicorn Platform website without writing any code.

![Suspicious submission attempt blocked by reCAPTCHA](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/frame-1-1_1sk24ie.png)

[reCAPTCHA](https://www.google.com/recaptcha/about/) is a free service by Google that protects your contact forms from spam.

Unicorn Platform provides ** Challenge (v2) ** integration. It will not interrupt your visitors unless their behaviour is considered suspicious.

Before we get started, please make sure that you:

* Have a Google account.

Table of contents:

1. [Step 1 – Register your website](#1-step-1-register-your-website)
2. [Step 2 – Add the site key](#1-step-2-add-the-site-key)
3. [Step 3 – Add the secret key](#1-step-3-add-the-secret-key)
4. [Troubleshooting](#1-troubleshooting)
5. [Privacy](#1-privacy)

# Step 1 – Register your website

To get started with reCAPTCHA 
visit the [Admin Console](https://www.google.com/recaptcha/admin).
Choose the type: reCAPTCHA v2 > Invisible reCAPTCHA badge.

![The required type of reCAPTCHA](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/chromedvz9gmhb5l_zj5kgb.png)

Add all domain names associated with your website.

![Domain registration field](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-14_1r24luk.png)

| reCAPTCHA detects subdomains automatically. For example, if you add `mysite.com` to the domain list, reCAPTCHA will also work for `www.mysite.com`, `blog.mysite.com`, etc.

Carefully read reCAPTCHA's Terms of Service before accepting and press **Submit**.

![Terms of Service by reCAPTCHA](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-9_aol45v.png)

And finally, copy the provided **site key**.

![The site key field](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-10_1yz5qp1.png)

# Step 2 – Add the site key

To activate reCAPTCHA for your website, go to the page editor. Start editing any component that contains a contact form and press **Activate reCAPTCHA**.

![reCAPTCHA activation button](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-11_kaoud0.png)

Enable reCAPTCHA and paste the site key that you copied previously.

![reCAPTCHA configuration menu](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-1_netcfz.png)

|| reCAPTCHA configuration is global. It means that changes made for 1 form will be applied to every other form on your website automatically.

Now save changes and open the live version of your website to see the result. If everything is configured correctly, you should see a small "protected by reCAPTCHA" badge at the bottom right corner.

![reCAPTCHA badge](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-13_1umaqcr.png)

# Step 3 – Add the secret key

After you’ve entered the site key, reCAPTCHA will start to verify user requests on the client side. For maximum security, you also need to enable server-side verification by using the secret key.

To do so, go to your reCAPTCHA [Admin Console](https://www.google.com/recaptcha/admin) > Settings, and copy the **secret key**.

![The secret key field](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_br1cku.png)

Then go back to Unicorn Platform and paste the key into the second field.

![Pasted secret key](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_1my1lxj.png)

Save changes and open the live version of your website. Try to submit a form to make sure that everything is configured properly. If the secret key is entered correctly, the form will be submitted successfully.

If there are issues with your secret key, you will see an error message when trying to submit a form. Please see the next chapter to learn how to handle this error.

A **Security Preference** slider allows you to adjust the security preference for the site. 
Value of the slider ranges from "Easiest for users" to "Most secure".

![](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/chromedhyulfajww_1th1nc5.png)

# Troubleshooting

If for some reason reCAPTCHA doesn't work properly, the badge should contain an error message. This message will allow you to identify and fix the issue.

![Example of an error message](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_mdshz3.png)

Here are some of the most possible issues.

###### reCAPTCHA badge doesn't appear on your website

Please make sure that you've enabled reCAPTCHA, entered the site key, and didn't hide the badge.

![Basic reCAPTCHA configuration](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-2_uzp85z.png)

| We suggest that you keep the badge visible until you make sure that reCAPTCHA is working properly. You can hide it later at any time.

###### "ERROR for site owner: Invalid site key"

This issue happens when the site key that you've entered is incorrect. To fix it:

1. Go to your reCAPTCHA [Admin Console](https://www.google.com/recaptcha/admin) > Settings, and copy the site key again.

![reCAPTCHA site key](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_1iprowy.png)

2. Paste it into the site key field.

![Pasted site key](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-11_kkxp7w.png)

3. Make sure that you saved the changes.

!["Save changes" button](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_1n9u5pf.png)

###### "ERROR for site owner: Invalid domain for site key"

This error appears when the registered domains are incorrect. To fix it:

1. Go to your reCAPTCHA [Admin Console](https://www.google.com/recaptcha/admin) > Settings.
2. Make sure that you've entered the correct domain names, and add the new ones if necessary.

![Domain registration field](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_13pgdmt.png)

###### [’invalid-input-secret’]

If there are issues with your secret key, you will see the following error when trying to submit a form.

![The secret key error message](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image-5_12qv441.png)

To fix it:

1. Go to your reCAPTCHA [Admin Console](https://www.google.com/recaptcha/admin) > Settings, and copy the secret key again.

![reCAPTCHA secret key](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_kjnc0c.png)

2. Paste it into the secret key field.

![Pasted secret key](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_1u9ac88.png)

3. Make sure that you saved the changes.

!["Save changes" button](https://storage.crisp.chat/users/helpdesk/website/7e782a40c0560c00/image_hm630c.png)

# Privacy

By activating reCAPTCHA on your website, you allow Google to collect the personal information of your visitors. Google's [Privacy Policy](https://policies.google.com/privacy) and [Terms of Service](https://policies.google.com/terms) apply.

Please explicitly inform your users that the website is protected by reCAPTCHA, and update your Privacy Policy if necessary.