🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 20, 2026

How to Add Friendly Captcha to Gravity Forms (Spam Protection Without Puzzles)

GravityExtra
How to Add Friendly Captcha to Gravity Forms (Spam Protection Without Puzzles)

Spam is the price of having a form on the web. Within days of publishing a contact form, the first fake enquiries arrive: links to dubious shops, made-up names, messages in languages your business does not speak. The usual cure, a CAPTCHA with pictures of crosswalks, annoys real people, hurts conversions and, in its most common form, sends data about your visitors to a large advertising company. In this tutorial you will add Friendly Captcha to Gravity Forms: a privacy-friendly check that stops bots without puzzles, cookies or tracking.

We use the Gravity Forms Friendly Captcha Premium Add-on from GravityExtra. It adds a Friendly Captcha field to the form editor and checks every answer on your server with your API key.

A Gravity Forms form called Workshop booking filled in by Olga Petrova, with the Friendly Captcha widget below the message showing a black shield with a check mark and the words I am human
The check finished in the background while the visitor was typing: no clicks, no picture puzzles.

What makes Friendly Captcha different

Friendly Captcha is built on proof of work. When a visitor starts filling in a form, their browser receives a small cryptographic puzzle and solves it in the background, which takes a moment of computing time. For one person sending one form, that cost is invisible. For a bot sending ten thousand forms, it adds up fast, and the puzzles get harder for suspicious traffic. The answer is then checked by Friendly Captcha’s servers, so a bot cannot simply invent one.

  • No picture puzzles: most visitors never have to do anything at all.
  • No cookies and no tracking: there is nothing to add to a cookie banner for it.
  • Made in the EU: Friendly Captcha is a German company, and its dedicated EU endpoint keeps the traffic in Germany.
  • Accessible: there is nothing to see or hear, so it works for people using screen readers or keyboard navigation.

Before you start

You need Gravity Forms 2.9 or newer, the add-on, and a Friendly Captcha account. In the Friendly Captcha dashboard, create an application for your website and copy its site key. Then create an API key on the API Keys page. Note whether your application is v2 (all new applications) or v1 (older ones), because the add-on needs to know which one it talks to.

Step 1: install the add-on and enter the keys

Upload and activate the add-on, then open Forms, Settings, Friendly Captcha and activate your licence key. In the Friendly Captcha keys section choose the widget version, paste the site key and the API key, and keep the Global endpoint unless your plan includes the EU endpoint. Leave Widget script on From this site: the add-on ships the official widget script and serves it from your own domain.

The Friendly Captcha keys section in Forms, Settings: Widget version v2 or v1, the site key, the API key field showing Saved, leave empty to keep it, the Endpoint choice Global or the dedicated EU endpoint hosted in Germany, the Widget script choice From this site or from the jsDelivr CDN, and the buttons Show the widget and Test the keys
One settings screen for the keys, the version, the EU endpoint and where the widget script comes from.

Click Test the keys. The add-on asks Friendly Captcha whether it accepts the keys and tells you in plain words if something is wrong, for example a v1 API key used with a v2 application. For a full test, click Show the widget, wait until it shows that the check is complete, and test again: now a real answer is checked from start to finish.

Step 2: decide what happens during an outage

No service is up all the time. In the Checking section you decide what happens when Friendly Captcha cannot be reached within the timeout. Friendly Captcha’s own advice is to accept the entry in that case, because losing every real enquiry for an hour is worse than letting a little spam through. That is the default here: the entry is saved and marked not checked, with a note explaining why. For forms where spam is expensive, such as free trials or voucher codes, choose fail closed instead and the visitor is asked to try again in a moment.

Wrong, expired or reused answers are always refused, whatever you choose. The outage rule only covers problems on the service side, and the last problem is shown at the top of the settings page so you notice it.

Step 3: add the field to your form

Open your form in the editor and add Friendly Captcha from Advanced Fields. Place it just above the submit button. Its default label is Spam protection; change it if you like. In the field settings you can pick when the widget starts, its theme and its language.

  • Start on focus is the best default: the puzzle starts when the visitor clicks into the first field, so it is usually finished by the time they reach the button, and nothing runs for people who only read the page.
  • Start at once suits pages whose only purpose is the form, such as a booking page.
  • Start on click waits until the visitor clicks the widget, for pages with many forms that are rarely used.
  • Theme: light, dark, or automatic to follow the visitor’s dark mode.
  • Language: automatic, or one of 35 languages if your page language is not detected correctly.

Step 4: test the form like a visitor

Open the page in a private window and fill in the form. Watch the widget: it changes from the start state to a check mark while you type. Send the form. If you are very quick and send before the check is done, the add-on waits a few seconds for it instead of showing an error, so impatient visitors are not punished.

Now test the protection. Open the browser’s developer tools and change the value of the hidden field named frc-captcha-response, or delete it, then send the form again. The add-on refuses the entry. This is exactly what a bot that skips the widget would see.

Step 5: check the entries

Open the entry in Forms, Entries. The Entry box shows Friendly Captcha: passed together with the event id that Friendly Captcha returns, so you can find the check in your Friendly Captcha dashboard if you ever need to. Entries accepted during an outage are marked not checked and carry a note with the reason. You can add a Friendly Captcha column to the entries list and filter by it.

The Entry box of a Gravity Forms entry showing the entry id, submission date, embed URL and the line Friendly Captcha: passed followed by the event id
Every entry shows the result of the check and the Friendly Captcha event id.

Multi-page forms, AJAX and Save and Continue

Long forms need special care with any CAPTCHA, because Gravity Forms validates every page again when the visitor finally submits, and a Friendly Captcha answer can only be used once. The add-on checks the answer once, when the visitor leaves the page that holds the field, and then carries the result to the last page with a signed pass that is valid for one entry and thirty minutes. You can put the field on the first page, where most bots stop, or on the last page.

AJAX forms work the same way: when another field has an error after the check passed, the form comes back marked Verified and the visitor simply fixes the field. Save and Continue sends nothing to Friendly Captcha, and the resume link shows a fresh widget. Several protected forms on one page each get their own widget.

Using the EU endpoint

If your organisation must keep visitor data in the EU, ask Friendly Captcha for a plan with the dedicated EU endpoint, enable it on your application, and choose Dedicated EU endpoint in the add-on. From then on the widget fetches its puzzles from servers in Germany and the add-on verifies answers through the EU address as well. For v1 applications you can let the widget fall back to the global service if the EU one is ever down.

Keep both endpoints enabled at first

Friendly Captcha advises enabling both the global and the EU endpoint on the application until you have confirmed that your forms work with the EU one. Then you can switch the global endpoint off.

Will it clash with my other spam protection?

No. The add-on only loads the Friendly Captcha script on pages with a protected form, and it uses its own names in the page, so the Gravity Forms reCAPTCHA field, Cloudflare Turnstile and hCaptcha keep working next to it, even on the same page. You can also keep the Gravity Forms honeypot switched on as an extra layer.

Tips for fewer false alarms and less spam

  • Keep the start mode on focus or auto, so the check is done before people reach the button.
  • Write a friendly custom error message in the field settings if your audience is not technical.
  • Look at the Friendly Captcha column now and then: many not checked entries mean your server had trouble reaching the service.
  • Combine it with good form design: fewer fields and clear labels reduce abandoned forms more than any CAPTCHA can.

Frequently asked questions

Is Friendly Captcha free?

Friendly Captcha has a free plan for small, non-commercial sites and paid plans for businesses. The add-on works with all of them; the dedicated EU endpoint needs an Advanced or Enterprise plan.

Do I still need a cookie banner entry for it?

Friendly Captcha sets no cookies and does no tracking, so it does not need consent in a cookie banner. Mention it in your privacy policy as a spam protection service.

What about people with old browsers or JavaScript turned off?

The widget supports old browsers such as Internet Explorer 11. Without JavaScript no puzzle can be solved, so the form shows a short note asking the visitor to turn JavaScript on.

With Friendly Captcha in place, your Gravity Forms forms stay open and friendly for real people while automated spam pays a price it cannot afford.

Stop form spam without puzzles, cookies or tracking

Get the Friendly Captcha add-on

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr