You are viewing beta documentation for Formie 4.x.
Captchas
reCAPTCHA
Follow the below steps to connect Formie to Google reCAPTCHA.
Step 1. Open the Captcha Settings
- Navigate to Formie → Settings → Captchas.
- Select reCAPTCHA in the left-hand sidebar.
- Turn on Enabled.
Step 2. Create your reCAPTCHA Keys
- Go to the reCAPTCHA Admin console (opens new window) or the Google Cloud reCAPTCHA page (opens new window).
- Create a new website key for the mode you want to use.
- Use a score-based key for reCAPTCHA v3.
- Use a challenge key for reCAPTCHA v2 Checkbox.
- For reCAPTCHA Enterprise, create a website key whose type matches the Enterprise key type you want to use in Formie.
- Add the domains where the form will run.
- Save the key.
- Copy the Site Key.
- Open the key details and use Use Legacy Key to reveal the legacy secret key for third-party integrations such as Formie.
- If you are using reCAPTCHA Enterprise, also note your Google Cloud Project ID.
Step 3. Connect Formie to reCAPTCHA
- Choose the reCAPTCHA Type in Formie.
- Paste the reCAPTCHA Site Key into the reCAPTCHA Site Key field.
- Paste the legacy secret key into the reCAPTCHA Secret Key field.
- If you are using reCAPTCHA Enterprise, select the Enterprise Key Type that matches the key you created and enter the Project ID.
- Optionally configure the other settings that apply to your chosen mode, such as Minimum Score, Badge Type, Theme, Size, Action, Language, and Script Loading Method.
- Save the captcha settings.
Step 4. Form Setting
- Go to the form you want to protect.
- Enable reCAPTCHA for that form.
- For multi-page forms, turn on Show on All Pages if reCAPTCHA should run on every page instead of only the final submit step.
- Save the form.
For most forms, reCAPTCHA v3 is the best starting point. Use the checkbox or Enterprise challenge modes only when you need a visible challenge.
Last updated: June 2, 2026, 3:49:12 PM