Plugin how-tos · Guide
How to Add reCAPTCHA to Fluent Forms (Step by Step)

Short answer
Create reCAPTCHA keys in Google's admin console, choosing v2 or v3 and adding your domain. In Fluent Forms Global Settings, select the same version, paste the site key and secret key, and save. Then add the reCAPTCHA field to each form and test it in a private window.
Key takeaways
- Fluent Forms supports reCAPTCHA in its free version.
- Create keys in Google's admin console and add your domain.
- Select the same reCAPTCHA version in Fluent Forms as your keys.
- Add the reCAPTCHA field to each form you want to protect.
- v3 and invisible v2 show only a badge, not a checkbox.
- Exclude reCAPTCHA scripts from JavaScript delay and combine settings.
How do you add reCAPTCHA to Fluent Forms?
Create reCAPTCHA keys in Google's admin console, enter them in Fluent Forms' global reCAPTCHA settings with the matching version, then add the reCAPTCHA field to each form you want to protect and save.
Fluent Forms supports Google reCAPTCHA in its free version, so you do not need Fluent Forms Pro for this. The process has three parts:
- Get a site key and secret key from Google.
- Connect them in Fluent Forms' global settings.
- Add the reCAPTCHA field to your forms.
The official Fluent Forms reCAPTCHA guide shows the current screens. Menu names can shift between versions, so use it alongside the steps below.
If you are new to the plugin, our guide to using Fluent Forms in WordPress covers form building basics.
Which reCAPTCHA version should you choose?
Choose reCAPTCHA v3 for no visible challenge and a background score, v2 checkbox for a familiar I'm not a robot box, or invisible v2 for a challenge that appears only when Google is suspicious.
| Version | What visitors see | Best for |
|---|---|---|
| v2 checkbox | A checkbox, sometimes an image puzzle | Simple sites that want visible protection |
| v2 invisible | Nothing, unless flagged as suspicious | Cleaner forms with a fallback challenge |
| v3 | Nothing, only a small badge | Smooth experience, score-based filtering |
Google's reCAPTCHA v3 documentation explains how scores work. The v2 checkbox documentation covers the visible widget.
Pick one version and use matching keys. Keys made for one type do not work with another.
Step 1: How do you create reCAPTCHA keys?
Sign in to the Google reCAPTCHA admin console, register a new site, choose the reCAPTCHA type, add your domain, and copy the site key and secret key it gives you.
- Go to the reCAPTCHA admin console and sign in.
- Click the plus icon to create a new site.
- Enter a Label you will recognize, such as your site name.
- Choose the reCAPTCHA type: score based (v3) or challenge (v2). For v2, pick checkbox or invisible.
- Under Domains, add your domain, such as
example.com. - Accept the terms and submit.
- Copy the Site key and Secret key.
Keep the secret key private. Do not paste it into page content, emails or public tickets.
If you also run a staging site on another domain, add that domain to the list or create separate keys for it.
Step 2: How do you connect the keys in Fluent Forms?
In your dashboard, open Fluent Forms' Global Settings, find the reCAPTCHA section, choose the same version you picked in Google, paste both keys, and save.
- Go to Fluent Forms > Global Settings.
- Open the reCAPTCHA section. In recent versions it sits with other security options such as hCaptcha and Turnstile.
- Select the reCAPTCHA version that matches your keys.
- Paste the Site Key and Secret Key.
- Click Save Settings.
For the v2 checkbox, Fluent Forms may ask you to complete the checkbox once on the settings page to confirm the keys work. Follow the prompt if you see it.
If saving fails with a key error, double-check that the version selected matches the key type in Google's console. A v3 key saved under v2 settings is the most common slip.
Step 3: How do you add reCAPTCHA to a form?
Open the form in the Fluent Forms editor, find the reCAPTCHA field among the advanced fields, drag it into the form above the Submit button, and save the form.
- Go to Fluent Forms > All Forms and click Edit on your form.
- In the field panel on the right, open Advanced Fields.
- Find reCaptcha and drag it into the form, usually just above the submit button.
- Click Save Form.
Fluent Forms only adds reCAPTCHA to forms that contain the field. If you have ten forms, add it to each one that faces the public.
For v3 and invisible v2, the field does not show a checkbox. Visitors will see a small reCAPTCHA badge in the corner of the page instead.
Step 4: How do you test that reCAPTCHA is working?
Open the form page in a private browser window, confirm the checkbox or badge appears, submit a test entry, and check that it arrives in Fluent Forms' entries.
Testing steps:
- Visit the page with the form while logged out.
- Look for the checkbox (v2) or the badge in the lower corner (v3 and invisible).
- Fill in the form and submit.
- Go to Fluent Forms > Entries and confirm your test entry is there.
If the checkbox or badge does not show, our guide to Fluent Forms reCAPTCHA not showing covers the usual causes. It is often caching or a script optimization setting.
Where should the reCAPTCHA field go in the form?
Place the reCAPTCHA field just above the Submit button, because that is where visitors expect it and it keeps the checkbox from interrupting the questions.
For the v2 checkbox, position matters for usability. A checkbox at the top of a long form gets ticked early and can expire before the visitor finishes. Google's tokens are short lived, so a checkbox near the end is more reliable.
For v3 and invisible v2, position matters less because nothing appears in the form itself. Putting the field near the button still keeps your forms consistent.
A few other placement tips:
- Multi-step forms: put reCAPTCHA on the last step, next to the final Submit button.
- Several forms on one page: each form can have its own field. Test each one, since some themes struggle with more than one widget per page.
- Narrow sidebars: the v2 checkbox has a fixed width. If it overflows, use the compact size where the field settings offer it, or switch to v3.
Can you use Fluent Forms reCAPTCHA inside Elementor or popups?
Yes, you can embed a protected form with the Fluent Forms shortcode or widget in Elementor, but forms inside popups need extra testing because the reCAPTCHA widget may load before the popup opens.
When a form sits inside a popup or a tab that is hidden on page load, the v2 checkbox sometimes renders with no size, or not at all. Open the popup on the live page and check that the checkbox or badge appears and that a test entry goes through.
If it fails only in the popup, try placing the form on a normal page and linking to it, or switch to v3, which does not need a visible widget. Our guide on Elementor popups not working covers other popup issues.
How do caching and speed plugins affect reCAPTCHA?
Speed plugins that delay or combine JavaScript can stop the reCAPTCHA script from loading, so exclude reCAPTCHA and Fluent Forms scripts from those settings after you add it.
Settings to look at include Delay JavaScript execution, Combine JavaScript and Defer JavaScript in plugins such as WP Rocket, LiteSpeed Cache and Autoptimize. Cloudflare's Rocket Loader can cause the same problem.
Add recaptcha and fluentform to the exclusion lists, then clear all caches. Our guide on how to clear cache in WordPress covers each common plugin.
Does reCAPTCHA need a cookie consent setup?
reCAPTCHA loads Google scripts and may set cookies, so sites under privacy laws such as GDPR should mention it in the privacy policy and check how their consent plugin handles it.
This is general information, not legal advice. Rules depend on where you and your visitors are.
Some consent plugins block Google scripts until visitors accept, which stops reCAPTCHA from loading. That protects privacy but can leave forms unprotected or broken. Complianz, for example, has a page on handling Fluent Forms and reCAPTCHA.
If consent blocking causes trouble, a privacy-focused alternative such as Cloudflare Turnstile or a honeypot may suit you better.
What other spam protection does Fluent Forms offer?
Fluent Forms also offers a honeypot, hCaptcha and Cloudflare Turnstile, and combining a honeypot with reCAPTCHA gives two layers of protection with little extra friction.
- Honeypot: a hidden field that bots fill in and humans do not. Enable it in Global Settings.
- hCaptcha: a reCAPTCHA alternative with a similar setup.
- Turnstile: Cloudflare's challenge, often invisible to visitors.
Use only one challenge service per form. Running reCAPTCHA and hCaptcha together adds friction without much gain.
Fluent Forms is free in the WordPress plugin directory. If you are weighing the paid version for other features, see is Fluent Forms free.
Frequently asked questions
Is reCAPTCHA free in Fluent Forms?
Yes. The free Fluent Forms plugin includes reCAPTCHA support, and Google's reCAPTCHA has a free usage tier that covers most small and medium sites. Very high-volume sites should check Google's current limits and pricing.
Should I use reCAPTCHA v2 or v3 with Fluent Forms?
Use v3 if you want no visible challenge and are comfortable with score-based filtering. Use v2 checkbox if you prefer a clear, familiar check. Both work in Fluent Forms, as long as your keys match the version you choose.
Why can I not see the reCAPTCHA checkbox after adding the field?
If you chose v3 or invisible v2, there is no checkbox, only a small badge in the page corner. If you chose v2 checkbox and see nothing, caching, a script delay setting or a consent plugin may be blocking Google's script.
Do I need to add the reCAPTCHA field to every form?
Yes, in most setups. Global Settings only stores the keys and version. Each form that should be protected needs the reCAPTCHA field added in the editor and saved.
Can I use the same reCAPTCHA keys on several sites?
You can add several domains to one key in Google's console, but separate keys per site are easier to manage. Separate keys also make it clearer which site is having problems when you check reCAPTCHA reports.
Sources
- Integrate reCAPTCHA Fluent Forms Docs
- Fluent Forms plugin WordPress.org
- reCAPTCHA v3 Google for Developers
- reCAPTCHA v2 Google for Developers
- WP Fluent Forms and reCAPTCHA Complianz
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


