How to Generate reCAPTCHA Keys

Why You Need reCAPTCHA

reCAPTCHA helps protect your forms from spam and abuse by verifying that submissions are coming from real humans, not bots. This is essential for:

• Preventing spam submissions to your email
• Protecting your forms from automated attacks
• Ensuring the quality of the data you receive
• Maintaining the security of your website

Static Forms requires reCAPTCHA integration to ensure all form submissions are legitimate.

Step 1: Access the reCAPTCHA Admin Console

1. Go to the Google reCAPTCHA Admin Console

2. Sign in with your Google account. If you don't have one, you'll need to create one.

Step 2: Register a New Site

1. Once logged in, click the + Add button to register a new site.

2. Enter a Label for your site (e.g., "My Website Forms")

   This is for your reference only and helps you identify this reCAPTCHA configuration later.

3. Select reCAPTCHA v2 or v3 as the type

   For v2: Choose "I'm not a robot" Checkbox - users will see and interact with the CAPTCHA.

   For v3 (Pro users only): Choose reCAPTCHA v3 for invisible protection without user interaction.

4. Add your Domains where the reCAPTCHA will be used

   Enter all domains where your forms will be embedded, one per line:

   • Your website domain (e.g., example.com, www.example.com)
   • Important: Add staticforms.xyz to allow Static Forms to verify submissions
   • For local testing, add localhost

5. Accept the Terms of Service and click Submit

Step 3: Get Your reCAPTCHA Keys

After registering your site, you'll be provided with two important keys:

Step 4: Add the Secret Key to Your Static Forms Settings

1. Log in to your Static Forms account

2. Navigate to Settings → CAPTCHA Settings

3. In the reCAPTCHA tab, select your reCAPTCHA version (v2 or v3 for Pro users)

4. Enter the Secret Key you obtained from the reCAPTCHA Admin Console

   If using v3, you can also configure the minimum score threshold (recommended: 0.5)

5. Click Save Key or Update Key to complete the configuration

Step 5: Implement reCAPTCHA on Your Website

To add reCAPTCHA to your form, you'll need to include the following elements in your HTML:

<form action="https://api.staticforms.xyz/submit" method="POST">
  <!-- Your API key from Static Forms -->
  <input type="hidden" name="accessKey" value="your-access-key-here" />
  
  <!-- Your form fields -->
  <input type="text" name="name" placeholder="Name" required />
  <input type="email" name="email" placeholder="Email" required />
  <textarea name="message" placeholder="Message" required></textarea>
  
  <!-- reCAPTCHA v2 widget - Replace YOUR_SITE_KEY -->
  <div class="g-recaptcha" data-sitekey="YOUR_SITE_KEY"></div>
  
  <button type="submit">Send</button>
  
  <!-- Include reCAPTCHA JavaScript -->
  <script src="https://www.google.com/recaptcha/api.js" async defer></script>
</form>

<form id="contactForm" action="https://api.staticforms.xyz/submit" method="POST">
  <input type="hidden" name="accessKey" value="your-access-key-here" />
  <input type="hidden" name="g-recaptcha-response" id="g-recaptcha-response" />
  
  <!-- Your form fields -->
  <input type="text" name="name" placeholder="Name" required />
  <input type="email" name="email" placeholder="Email" required />
  <textarea name="message" placeholder="Message" required></textarea>
  
  <button type="submit">Send</button>
</form>

<!-- reCAPTCHA v3 Script - Replace YOUR_SITE_KEY -->
<script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"></script>
<script>
  document.getElementById('contactForm').addEventListener('submit', function(e) {
    e.preventDefault();
    grecaptcha.ready(function() {
      grecaptcha.execute('YOUR_SITE_KEY', {action: 'submit'}).then(function(token) {
        document.getElementById('g-recaptcha-response').value = token;
        document.getElementById('contactForm').submit();
      });
    });
  });
</script>

Troubleshooting

Need More Help?

If you're still having trouble setting up reCAPTCHA, you can:

• Visit the official reCAPTCHA documentation
• Contact our support team