ToolkitSuitePopupGoogle reCAPTCHA Integration
Integrations

Google reCAPTCHA Integration

Note: Integrations must be set up by a Toolkit admin. To connect any of the integrations below, contact support and let us know which integration you'd like added to your account.

Google reCAPTCHA Integration

Add Google reCAPTCHA to your Popup widgets to protect forms from spam and bot submissions.

Step 1: Create a reCAPTCHA Site

  1. Go to developers.google.com/recaptcha and sign in.
  2. Click Register a new site (or the + icon).
  3. Enter a Label for your site.
  4. Choose the reCAPTCHA type: v2 ("I'm not a robot" checkbox) or v3 (invisible score-based).

Step 2: Configure Domains

In the reCAPTCHA site settings, add the following domains:

  • Your website domain (e.g. yoursite.com).
  • Your Popup dashboard domain, so reCAPTCHA works in the widget preview/editor.

Step 3: Copy Your Keys

After registering, Google provides two keys:

  • Site Key -- Used on the frontend (visible in your widget).
  • Secret Key -- Used on the backend for verification.

Copy both keys.

Step 4: Add Keys to Popup

  1. In your Popup dashboard, go to Settings > Captcha Settings.
  2. Toggle reCAPTCHA to Enabled.
  3. Paste your Site Key and Secret Key into the corresponding fields.
  4. Save.

Step 5: Add reCAPTCHA to a Widget

  1. Open your widget in the Popup editor.
  2. In the form, click Add Field.
  3. Select reCAPTCHA from the field type list.
  4. The reCAPTCHA element appears in your form.

Customization

You can customize the reCAPTCHA appearance:

  • Theme -- Choose between Light or Dark theme to match your widget design.
  • Size -- Choose between Normal or Compact size.

Need more help?

If you've worked through this and still need a hand, contact support -- we'll dig in with you.