Note: While our most popular guides have been translated into Spanish, some guides are only available in English.

Adding Google reCAPTCHA to forms

To help reduce spam, add Google reCAPTCHA to Form Blocks, Newsletter Blocks, promotional pop-ups, and product waitlists. Google reCAPTCHA prompts visitors to check a box to prove that they’re not a robot before they submit their information. In some cases, they’re prompted to complete another task, like identify a string of letters. This method makes it difficult for spambots to complete form submissions.

To enable reCAPTCHA, you'll need a Google account. This integration uses reCAPTCHA V2.

Enable Google reCAPTCHA

Note: Changing your Google reCAPTCHA settings falls outside the scope of our support. For more help with steps one through eleven in this section, visit Google's documentation.

Before you can add Google reCAPTCHA to Form Blocks, Newsletter Blocks, promotional pop-ups, and product waitlists, enable it in Advanced Settings:

  1. In the site Settings panel, click Advanced, then click External API Keys and scroll down to Google reCAPTCHA.
  2. Click the link to get your Google reCAPTCHA API Keys. The link will open in a new tab.
  3. Click Admin Console.
  4. Enter a label to help you identify your site. This can be your website URL, or a nickname.
  5. Select reCAPTCHA V2. Squarespace doesn't support reCAPTCHA V3.
  6. Select "I'm not a robot" Checkbox. The other options aren't supported.
  7. Enter your built-in domain and click the + icon. Use the format yoursite.squarespace.com, excluding https:// from the beginning.
  8. Enter your custom domain and click the + icon. Repeat this step for any other custom domains connected to your site, excluding https:// from the beginning of each one.
Note: Ensure you add all domains associated with your site. Google reCAPTCHA only works on domains that are added in step seven.

Creating a new reCAPTCHA in the Google reCAPTCHA dashboard.

  1. Add another Owner, if there are other people who will be viewing your site's Google reCAPTCHA analytics.
  2. Accept the Google reCAPTCHA terms of service. 
  3. Click Submit.
  4. Copy your Site Key and Secret Key and paste them somewhere easily accessible.

The Site Key and Secret Key in the reCAPTCHA dashboard.

Note: API keys are sensitive. Keep these keys secure. Treat them like you would treat any password.
  1. Back in the External API Keys panel, paste your API keys.

The External API Keys panel in Squarespace.

  1. Click Save.

Enable Google reCAPTCHA for newsletter signups

Alternatively, you can enable Google reCAPTCHA directly from a Newsletter Block or promotional pop-up:

  1. Click Edit on the page with your Newsletter Block, then click Edit on the block.
  2. Click Verification and find your API key fields under reCAPTCHA.
  3. Follow the steps above starting from step 2.
  1. In the Home Menu, click Marketing, click Promotional Pop-Up, then click Action.
  2. Select Sign up for a newsletter.
  3. Click Verification and find your API key fields under reCAPTCHA.
  4. Follow the steps above starting from step 2.

If you don't see API key fields in the Verification tab, Google reCAPTCHA has already been enabled on your site, either in Advanced Settings or in another form. You only need to enable Google reCAPTCHA once on your site to add it to forms.

Add Google reCAPTCHA to a form

After you enable reCAPTCHA, it's added to product waitlists automatically. To add it to Form Blocks, Newsletter Blocks, and promotional pop-ups:

  1. Click Edit on the Form Block, click Captcha, then check Add Google reCAPTCHA.
  2. Customize the theme and alignment using the drop-down menus.
  3. Click Apply.
  4. Repeat these steps for all Form Blocks on your site where you want to add a reCAPTCHA.
  1. Click Edit on the Newsletter Block, click Verification, then check Turn on reCAPTCHA.
  2. Click Apply.
  3. Repeat these steps for all Newsletter Blocks on your site where you want to add a reCAPTCHA.
  1. In the Home Menu, click Marketing, click Promotional Pop-up, then click Action.
  2. Select Sign up for a newsletter and check Turn on reCAPTCHA.
  3. Finish setting up your newsletter and click Save.

Here’s how Google reCAPTCHA will look:

newCaptchaAnchor.gif

If you change your domain, update reCAPTCHA settings

Google reCAPTCHA only works with the domains you enter during the registration process. If you change your built-in Squarespace domain or connect a new domain to your site, you’ll need to add it to your API Key settings on Google. It can take up to 30 minutes for domain updates to take effect.

  1. In the Settings panel, click Advanced, then click External API Keys.
  2. Scroll down to Google reCAPTCHA.
  3. Click Google reCAPTCHA API Keys.

The link will open the Google reCAPTCHA site in a new tab.

  1. Click Admin Console.
  2. From the drop-down menu, select the reCAPTCHA you want to update.
  3. Click the in the top-right corner.
  4. Add your new domain to the Domains list.
  5. Click Save.

Troubleshooting

Error message: Invalid domain for site key

If you don’t correctly add all your site's domains during Google reCAPTCHA registration, you’ll get an error that says ERROR for site owner: Invalid domain for site key.

To resolve, add the domain and refresh the page with the block. It can take up to 30 minutes for domain updates to take effect.

Error message: Invalid key type

If you select reCAPTCHA V3 during Google reCAPTCHA registration, you'll get an error that says ERROR for site owner: Invalid key type. Squarespace doesn't support reCAPTCHA V3.

To resolve, create a new reCAPTCHA by clicking the icon in the top-right corner of your Google reCAPTCHA dashboard, and select reCAPTCHA V2 during creation. Then add the new keys to the External API Keys panel on Squarespace, and click Save.

Error message: Unable to submit form. Please try again later

If you accidentally copy additional text into the Secret Key field in your Squarespace site's settings, you'll get an error when trying to submit the form or newsletter signup that says Unable to submit form. Please try again later.

To resolve, copy the Secret Key from the reCAPTCHA dashboard, ensuring only the Secret Key text gets copied, then paste it in the Secret Key field of the External API Keys panel in your Squarespace site.

Checking Google reCAPTCHA sends visitors to the bottom of the page

On iOS devices, checking the Google reCAPTCHA box sends visitors to the bottom of the page. This is caused by an issue between iOS and Google, and isn't something we're able to resolve.

Was this article helpful?
148 out of 214 found this helpful
Adding Google reCAPTCHA to forms