Skip to main content

Google reCAPTCHA

important

We're in the middle of some fast-moving changes to the Forem Admin experience, so we've paused documentation updates for the time being. You may find that the docs are now outdated in parts. If you have any questions, please visit forem.dev to request additional support. We thank you for your patience and hope you're liking the changes!

Creating your reCAPTCHA App#

  1. First, visit the admin panel to create an app for your Forem: https://www.google.com/recaptcha/admin/create
  2. Fill out the appropriate fields:
    1. Label: Your Forem name (for ex. My Forem)
    2. reCAPTCHA Type: reCAPTCHA v2
      1. Choose the default, "I'm not a robot" Checkbox
    3. Domains: your-domain.com
  3. Check the "Accept the Terms of Service" checkbox.

Before submitting, it should look like this:

Once you've clicked submit, you should see your site and secret keys:

Please add them to your Forem's config section in the Email address section of Config > Authentication:

  1. First, visit your Forem's config section.
  2. Under Authentication, find the Email address field.
  3. Hit "Enable" for Email address. Note that this is only temporary, if you do not want to enable email address registration for your Forem.
  4. Check the Enable Google reCAPTCHA for email password registration box.
  5. Paste in the appropriate Google reCAPTCHA keys.