Skip to content

Anti-Spam Settings

Anti-Spam settings are organized into three panels: reCAPTCHA v3 Settings, Honeypot Field Settings and Blacklist — three layers of protection against bot submissions.

reCAPTCHA

Enable reCAPTCHA

A dropdown selecting how reCAPTCHA works:

  • Disabled: reCAPTCHA off.
  • reCaptcha v2: shows the "I'm not a robot" checkbox requiring explicit user verification.
  • reCaptcha v3: invisible verification scoring user behavior automatically — the default.

Getting keys

To use reCAPTCHA (v2 / v3), sign up for an API key pair for your site — it consists of a site key and a secret.

Domain

The service domain the reCAPTCHA script loads from:

  • www.google.com: default.
  • www.recaptcha.net: Google's mirror domain, for networks where www.google.com is unreachable.

Site key

The site key used in the code your site serves to users.

Secret key

The key for communication between your site and Google — keep it a secret.

Captcha Score (v3 only)

The minimum score threshold for reCAPTCHA v3, range 0.1 ~ 1, default 0.5. Requests scoring below the threshold are rejected. The smaller the value, the looser the restriction — lower it slightly if legitimate users get blocked.

Theme (v2 only)

The v2 widget's color theme: light (default) / dark.

Type (v2 only)

The type of CAPTCHA v2 serves: image (default) / audio — helpful for visually impaired users.

Size (v2 only)

The v2 widget's size: normal (default) / compact.

Honeypot Field

Enable Honeypot Field

When enabled, invisible "honeypot" fields are injected into the form. Bots tend to fill every field and expose themselves; real users never touch them. Honeypot verification does not affect the user experience and also prevents duplicate submissions.

History

The hidden-field verification in early versions was replaced by the honeypot mechanism and blacklist rules in 8.9.

Blacklist

Enable Blacklist

When enabled, submissions are blocked by the three blacklists below. Available since 8.9.

Email Blacklist

Submissions from email addresses on the list are blocked — fill in one mailbox per line.

Pulls the email blacklist from an external URL and merges it with the local list, for example:

https://www.dnngo.net/blacklist/mail.txt

IP Blacklist

Submissions from IP addresses on the list are blocked, one IP per line.

Pulls the IP blacklist from an external URL, e.g. https://www.dnngo.net/blacklist/ip.txt.

Keywords Blacklist

Submissions containing keywords on the list are blocked, one keyword per line — ideal for common spam promotion words.

Pulls the keyword blacklist from an external URL, e.g. https://www.dnngo.net/blacklist/keywords.txt.

TIP

With external links, multiple sites can share one centrally maintained blacklist file (a plain .txt works) — no manual updates in each admin.

ScenarioRecommendation
Ordinary contact formreCAPTCHA v3 + honeypot field
Heavy spam pressurereCAPTCHA v2 (checkbox) + honeypot + keyword blacklist
Prefer no Google serviceHoneypot + email/IP/keyword blacklists
google.com unreachablereCAPTCHA (Domain set to www.recaptcha.net) + honeypot

Next Steps

Built with VitePress