Help
/Widget

Adding reCAPTCHA to the Widget

This article provides an overview of the process of adding reCAPTCHA to the VerifiedEmail widget.

  1. Prepare your environment. In this step, you will:
    • Sign up for a Google account if necessary.
    • Create or select a Google Cloud project.
    • Enable the reCAPTCHA Enterprise API for the project.
    • Configure roles and permissions. As directed in the document linked above, be sure to grant yourself the following IAM roles on the project:
    • reCAPTCHA Enterprise Admin
    • reCAPTCHA Enterprise Agent
  2. Create a score-based reCAPTCHA key.
  3. On the VerifiedEmail Widgets page, click the triple dot button in the widget to which you want to add reCAPTCHA, and select Edit Details.
    4. Select Edit Details
  4. Copy and paste your Google Cloud Project ID into the designated field.
    5. Copy and paste your Google Cloud Project ID
  5. Copy the score-based reCAPTCHA key to the Recaptcha Key ID (Site Key) field.
    6. The Recaptcha Key ID (Site Key)
  6. Create a service account: https://cloud.google.com/iam/docs/service-accounts-create.

    7. 💡 Note: In step 6 of the process described on that page, assign the role reCAPTCHA Enterprise Agent to the service account.

  7. Create a service account key: https://cloud.google.com/iam/docs/keys-create-delete.
  8. Download the JSON file and store its contents in Recaptcha Service Key.
    9. The Recaptcha Service Key
  9. Click Save. If you have not already done so, follow the steps provided in the next dialog to embed the widget on your website.

💡 Note: If you have previously embedded the widget on your website, be sure to update the <head> script after adding reCAPTCHA.

The head script