> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# ReCaptcha 2

> **Note**
>
> This is archived documentation for the legacy Blueprint theme framework. For current storefront documentation, see [Stencil](/developer/docs/storefront/stencil/getting-started) or [Catalyst](/developer/docs/storefront/catalyst/getting-started).

To deter spam submission through storefront forms, BigCommerce now supports Google [reCAPTCHA v2](https://support.google.com/recaptcha/?hl=en#6080933) challenges, to distinguish human customers/visitors from automated bots.

## Better Spam Deterrence

We recommend that all storefront themes take advantage of this upgraded bot detection. However, BigCommerce's legacy Blueprint themes were last published in our Theme Marketplace before we implemented reCAPTCHA v2. Therefore, please use the following instructions to update your Blueprint-based theme with the best-available deterrent against automated spam.

## How to Upgrade

To incorporate reCAPTCHA v2, you will need to update script references in these three template files:

* `Panels/CreateAccountForm.html`
* `page_contact_form.html`
* `product_comments.html`

> **Note**
>
> **Updating Safely**
> Please back up each file before making any changes.

The instructions below are based on the default Blueprint theme (Classic Next), as it was last published in BigCommerce's Theme Marketplace. Therefore, the HTML markup will vary, based on customizations you have already made to this theme, or to other Marketplace themes.

### Script Tag to Remove

Search each of the three template files for a `<script>` tag like the following. If you find it, delete the whole tag. (This script invokes a legacy reCAPTCHA v1 challenge:)

**`Script Tag to Remove`**

```html title="Script Tag to Remove" showLineNumbers={false}
<script type="text/javascript"> 
 var RecaptchaOptions = { 
    theme : 'clean' or 'white' 
    }; 
 </script>
```

### Variable to Remove

Alternately, you might see the same `RecaptchaOptions` variable inside a different `<script>` tag at the top of the same three templates. If so, delete the lines shown here:

**`Variable to Remove`**

```js title="Variable to Remove" showLineNumbers={false}
var RecaptchaOptions = { 
 theme : 'clean' or 'white'
};
```

### reCAPTCHA Script to Update

In each of the three template files, add the following script tag to the top of the page.

**`Script Tag to Update`**

```html title="Script Tag to Update" showLineNumbers={false}
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
```

Then replace the "before" code block just below with the simplified "after" code that follows.

#### Replace this (before):

**`Script Tag to Remove`**

```html title="Script Tag to Remove" showLineNumbers={false}
<script type="text/javascript" src="https://www.google.com/recaptcha/api/challenge?k=%%GLOBAL_ReCaptchaAPIKeyPublic%%">
</script>

<noscript>
    <iframe src="https://www.google.com/recaptcha/api/noscript?k=%%GLOBAL_ReCaptchaAPIKeyPublic%%" height="300" width="500" frameborder="0">
    </iframe>
    <br />
    <textarea name="recaptcha_challenge_field" rows="3" cols="40">
    </textarea>
    <input type="hidden" name="recaptcha_response_field" value="manual_challenge">
</noscript>
```

#### ...with this (after):

```java title="" showLineNumbers={false}
%%GLOBAL_ReCaptchaMarkup%%
```

## Supported Browsers

Below are the browsers supported for the BigCommerce control panel. We drop support when a version falls below 2% of usage. The browsers are sorted by popularity, with the most popular browsers at the top.

| Desktop        |
| :------------- |
| Chrome latest  |
| Firefox latest |
| Safari latest  |

For a current list of target browsers (desktop and mobile) that BigCommerce supports for *storefronts* using our themes, please see our [article on supported browsers](https://support.bigcommerce.com/s/article/Themes-Supported-Browsers?language=en_US).