Template Files
Templates Directory
Custom Templates
Customize Stencil Checkout
Handlebars Syntax and Helpers
Handlebars.js
Handlebars Helpers
Stencil Object Model
Stencil Objects

Adding ReCAPTCHA V2

Better Spam Deterrence

reCAPTCHA v1 was deprecated as of March 31, 2018. To deter spam submission through storefront forms, BigCommerce now supports Google reCAPTCHA v2 challenges, to distinguish human customers/visitors from automated bots. We recommend that all storefront themes take advantage of this upgraded bot detection.


Themes that Already Incorporate reCAPTCHA V2

If you have based your theme on a theme/version that already incorporates reCAPTCHA v2, you do not need to take any further action. Compliant themes/versions currently include:

  • Cornerstone 1.6.1 or higher
  • 22 Savile Row (all versions)
  • Arcade 1.13.0 or higher
  • Atelier 1.10.1 or higher
  • Bazaar 1.0.1 or higher
  • Capacity 1.12.0 or higher
  • Chelsea 1.12.0 or higher
  • Diamond 1.0.5 or higher
  • Exhibit 1.10.4 or higher
  • Flagship 1.10.6 or higher
  • Fortune 1.12.1 or higher
  • Foundry 1.10.1 or higher
  • Geneva 1.10.1 or higher
  • Hero 1.11.1 or higher
  • Lookbook 1.10.3 or higher
  • Merchant 1.12.0 or higher
  • Mogul 1.0.7 or higher
  • Parts Warehouse (all versions)
  • Peak 1.11.4 or higher
  • Prosper 1.10.2 or higher
  • Queen 1.0.3 or higher
  • Runway 1.11.2 or higher
  • Scales 1.0.2 or higher
  • Showroom 1.12.0 or higher
  • Soho 1.11.1 or higher
  • Solo 1.10.3 or higher
  • Spotlight 1.11.0 or higher
  • Supermarket (all versions)
  • Touch 1.0.1 or higher
  • Venture 1.11.4 or higher

However, if your theme is built on an earlier version of these themes, or on a different base theme, follow the updating instructions in How to Upgrade below.


How to Upgrade

To add reCAPTCHA v2 support to a theme, you will need to update script references in three template files:

See PR #951 on the Cornerstone Github Repository to see differential for each of the files that need to be modified and how.