formsieve Docs Support
All docs pages

Settings reference

All settings live under Formsieve → Settings, in six sections: Connection, Detection, Forms, Privacy, Lists and Advanced. Only administrators (the manage_options capability) can see or change them. The settings are site-wide: on a site with both Gravity Forms and Contact Form 7 they apply to the forms of both, and each form can override some of them (Per-form settings for Gravity Forms, Per-form settings for Contact Form 7).

Labels are shown as they appear on the screen, values in bold are the defaults, and the stored key is shown in brackets for developers (option formsieve_settings).

Connection

Nothing is sent until a Formsieve key is present and consent is given.

Setting Values What it does
Formsieve key text Your key (FS-XXXX-XXXX-XXXX-XXXX), from your account at https://formsieve.com/account/ or a free trial at https://formsieve.com/start/ (Getting a Formsieve key). While no key is saved, the Start your free trial card above it (version 1.2.0 and later) creates a trial key and saves it here in one click. Stored in its own option with autoload off, obfuscated at rest, displayed masked. Never exported or logged. The constant FORMSIEVE_API_KEY overrides it.
Disconnect checkbox Removes the saved key and frees this site's slot on your plan. Deleting the plugin frees the slot too.
What is sent (consent) checkbox Lists exactly what is sent, to whom (Thinking42, then OpenRouter and TypeSafe AI, Inc. as its sub-processors) and where, with links to the Terms, the Data Processing Agreement and the privacy policy. Tick it to agree; withdraw it on the Privacy tab.
Test connection button One real call with a canned sample. It does not count as an AI check (20 tests a day per key, 5 on the Free plan, as of 2026-09-29). It shows your plan, this month's AI checks, this site's slot, the model and the latency. See Getting started.

Run the setup wizard opens the wizard again.

Detection

Your site

Setting Values What it does
What this site does [site_description] text, up to 1,000 characters Sent with each check so Jev knows what a real enquiry to your site looks like.
Languages visitors write in [site_languages] language codes such as en, es; empty = the site language When the first one is not English, both thresholds move up by 0.05 (a precaution, see Calibration).

Sensitivity

Setting Values What it does
Preset [preset] Low, Medium, High Review and block thresholds: Low 0.65 / 0.92, Medium 0.50 / 0.85, High 0.40 / 0.75.
Review threshold (advanced), Block threshold (advanced) [threshold_review, threshold_block] a fraction (0.85) or a percentage (85 or 85%); empty (use the preset) Numeric override for advanced users. 1 means 100%, so a block threshold of 1 never blocks. An entry that is not a valid threshold (text, a negative number, more than 100) is refused with a message and the previous value is kept. If the review threshold is not below the block threshold, saving shows a warning: nothing then goes to review. Never shifted for language.
Review band [review_action] Deliver and tag the subject "[Possible spam NN%]", Send to spam What happens to submissions between the two thresholds.
When the AI check cannot answer [fail_mode] Fail open: deliver, noted "not checked", Hold for review: treat as the review band, noted "not checked", Fail closed: send to spam, noted "not checked" (outages and caps only) Fail closed applies only to timeouts and errors, an open circuit breaker after errors, and your own per-form hourly limit. When your plan stops the AI check (no active plan, this site not on the plan, monthly allowance used, or the key no longer accepted after a refund or dispute), submissions are delivered, or held for review if you choose Hold for review: Formsieve never blocks a form because of billing. A missing key or consent always delivers. The note "Not checked (…)" goes on the entry (Gravity Forms), or "Formsieve: not checked (…)" goes to Flamingo and the Formsieve log, and the mail itself is not tagged (Contact Form 7).
Aggressive mode [aggressive_mode] off Blocks without an API call when two or more strong local hints match (Pre-filters).
Notes [annotate_all] off Also adds a Formsieve note to allowed entries (Gravity Forms) and Flamingo messages (Contact Form 7); review, block and not-checked ones always get one.

Protect your allowance

Setting Values What it does
Most AI checks per form per hour [hourly_cap] number; 0 = off Maximum requests to Formsieve's service per form per clock hour. Every request sent counts, a retry included. Useful against bot waves: above it, submissions follow the fail mode and use no AI check.

Your plan sets the monthly allowance; there is no monthly setting in the plugin. See Plans, AI checks and limits.

Free local checks

These run on your server before the AI check and cost nothing; see Pre-filters for how each one decides.

Setting Default Notes
Trusted users [allowlist_logged_in] on Gravity Forms: logged-in users who can edit Gravity Forms entries or forms skip the check; authors and contributors are checked like visitors. Contact Form 7: logged-in users who can edit the contact form (Editor and up by default) skip the check.
Honeypot [honeypot] on Contact Form 7 forms: blocks when Formsieve's own hidden trap field _fsv_hp is filled. Gravity Forms has its own honeypot: turn on "Anti-spam honeypot" in each form's settings (Form Options). Formsieve adds no second trap field to Gravity Forms forms, and entries that honeypot marks as spam are not sent for checking. The setting shows only when Contact Form 7 is active.
Timing [timing], Minimum seconds [timing_min_seconds] on, 3 (1–60) Submissions sent faster than the minimum are blocked.
Trivial content [trivial] on Submissions without free text are allowed without an API call.
Replay cache [replay] on Reuses the verdict for identical text for 7 days; the same text from 3 or more IP addresses is blocked.
Rate limit [rate_limit], Submissions allowed [rate_limit_max], Within seconds [rate_limit_window] on, 5, 600 More submissions than allowed from one IP address within the window are blocked. While it is off, nothing is counted and the model is not told how many submissions came from the address in the last hour.
Blocklists [blocklist] on The Always block lists and learned blocked senders. While it is off, Disallowed comment keys and Disposable email have no effect either.
Disallowed comment keys [use_disallowed_keys] on WordPress's Settings → Discussion → Disallowed Comment Keys also block form submissions (needs Blocklists on).
Disposable email [disposable] on Blocks throwaway e-mail domains from the bundled list (needs Blocklists on).
Heuristics [heuristics] on Local hints (shorteners, repeated values, crypto addresses, prompt-injection patterns, a field longer than 20,000 characters and others) used for aggressive mode and the injection rule; they are not sent to the model. Link, phone, writing-system and length signals are sent either way.

Forms

A table of every Gravity Forms and Contact Form 7 form (up to 100), with its form plugin, its decisions and blocked submissions over the last 30 days, a link to its log rows and a Formsieve settings link to that form's own settings (Per-form settings for Gravity Forms, Per-form settings for Contact Form 7). Every form is checked with the global settings unless its own settings say otherwise.

Privacy

Setting Values What it does
Email domain [send_email_domain] on Sends only the domain of the visitor's e-mail address, never the full address. Off sends no e-mail information at all.
Phone numbers [redact_phone] on Replaces phone numbers with [phone] before sending.
AI notice under forms [ai_notice] Automatic, Always show, Never show Prints "Submissions are screened for spam by an automated AI service." under each form. Automatic means on with the Formsieve key (the Formsieve Terms ask you to tell visitors). Forms can override it.
Keep decision log for [retention_days] 30 days, 90 days, 1 year, Keep until deleted A daily task deletes older rows.

The Privacy tab (next to Settings) shows exactly what is sent, the privacy-policy text to copy into your policy and the consent status, and lets you withdraw consent. See Privacy kit.

Lists

One entry per line, up to 1,000 per list. The lists are saved separately from the other settings (option formsieve_lists), are not loaded on every page of your site, and are read only when a check needs them.

Setting Accepts
Always allow: Email addresses, Email domains, IP addresses or ranges [allow_emails, allow_domains, allow_ips] full addresses; domains such as partner.example; IPv4 or IPv6 addresses and CIDR ranges such as 203.0.113.0/24. Addresses and domains match what the visitor types, and IPs match the address the form plugin reports (Pre-filters); never list your own site's address or domain.
Always block: Email addresses, Email domains, IP addresses or ranges [block_emails, block_domains, block_ips] the same; a blocked domain matches the sender's e-mail domain or the domain of any link in the message
Always block: Words or phrases [block_keywords] words or phrases, matched case-insensitively in the submitted text

Allow lists win over everything else. Learned from your corrections shows how many trusted and blocked senders Formsieve has learned (Feedback loop); they are stored as e-mail hashes and are not editable.

Advanced

Setting Values What it does
Test mode [test_mode] off Simulated verdicts, nothing sent, red admin-bar badge (Getting started).
Strict calibration [strict_calibration] off While the service answers with an unrecognised model version, would-be blocks go to review instead (Calibration).
Error email [error_email] off At most one e-mail a day to the site administrator when errors occurred.
Uninstall [delete_on_uninstall] off "Delete all Formsieve data when the plugin is deleted": settings, key, consent record, learned lists and decision log. Deactivating never deletes anything.

Below the settings, Advanced has an Updates panel with Install Formsieve updates automatically (recommended), off until you tick it. It is not a Formsieve setting but WordPress's own automatic-update setting for the plugin, the same as Enable auto-updates on the Plugins screen, so it is not exported and a change on either screen shows on the other. Changing it needs the update_plugins capability; see Updates for when it cannot be changed.

Advanced also shows the Endpoint in use (and whether a constant or filter overrides it), the Unrecognized model versions seen so far, Export and import settings (a JSON file with the settings and the lists, never the key, the consent record or the learned senders) and a link to run the setup wizard again. An import never changes Test mode or Uninstall on the receiving site.

Constants for wp-config.php

Constant Effect
FORMSIEVE_API_KEY Formsieve key; wins over the formsieve_api_key filter and the saved key.
FORMSIEVE_API_BASE Replaces the service's base URL (for a local test server).

The constants of the two earlier plugins (FSV_GF_API_KEY, FSV_CF7_API_KEY, FSV_GF_API_BASE, FSV_CF7_API_BASE) are still read as a fallback until version 1.2.0 (as of 2026-09-26), and Formsieve shows a notice asking you to rename them.

Filters for the same purposes are listed in Developer hooks and WP-CLI.