Getting started
Setting up takes about five minutes: install the plugin, start the free trial from the setup wizard in one click, describe your site. Already have a Formsieve key? Paste it instead, give consent and test the connection.
1. Install
-
In WordPress go to Plugins → Add New Plugin, search for "Formsieve", then Install Now and Activate (Installing from WordPress.org). Or download the zip from Formsieve's page on WordPress.org, then upload it under Plugins → Add New Plugin → Upload Plugin and activate it.
-
Formsieve needs WordPress 6.6 or later and PHP 7.4 or later, and at least one form plugin it protects:
- Gravity Forms 2.9 or later: its module turns on while Gravity Forms is active.
- Contact Form 7 6.0 or later: its module turns on while Contact Form 7 is active. Flamingo is recommended, so that blocked submissions are kept and can be restored.
When neither is active, Formsieve shows a notice and checks nothing. When a site uses both, one plugin, one key, one set of settings and one log cover both. The Dashboard lists the form plugins Formsieve found. What Formsieve adds to each: AI spam filter for Gravity Forms and AI spam filter for Contact Form 7.
-
Did the site run Formsieve for Gravity Forms or Formsieve for CF7 before? Activating Formsieve moves their settings, lists and log; deactivate the old plugin if Formsieve did not switch it off (Moving from the two earlier plugins).
The free local checks start working at once on every enabled form, with no key and before consent (Pre-filters).
2. Run the setup wizard
Open Formsieve in the admin menu. The wizard starts the first time; Skip for now takes you to the plugin's Dashboard, Settings, Log and Privacy tabs, and Settings → Connection → Run the setup wizard brings it back.
Start your free trial (no key yet). From version 1.2.0 the wizard's first card is Start your free trial: 14 days or 500 AI checks, whichever comes first, no card (as of 2026-10-18).
- Check the e-mail address. It is filled in with yours; your Formsieve account uses it, and the trial details go there.
- Read what is sent. The card lists what goes to formsieve.com to create the trial (that address, this site's address and whether it is a production, staging or development site, the Formsieve version, the form plugins Formsieve works with, the site language and the sentence you tick) and, below it, the same "What is sent, and to whom" list as the consent screen.
- Tick the box, which accepts the Terms of Service and the Data Processing Agreement and agrees that form submissions are sent as described, then click Start free trial and connect.
One click creates your account and trial key on formsieve.com, saves the key in the plugin, records your consent and runs Test connection; you land on the Dashboard with "You're protected". Nothing is sent before you click. The free trial from the plugin is for live sites: on a local, development or staging address, start on formsieve.com instead. If the address already has a Formsieve account, the plugin says so and we e-mail that address a sign-in link, so you can copy your key from your account.
The card keeps two other ways: Start on formsieve.com instead opens https://formsieve.com/start/ (your e-mail address and a 6-digit code, then copy the key), and I already have a key jumps to the key field below. See Getting a Formsieve key.
Formsieve key (you already have one). Paste the key. It is stored in its own option (not autoloaded), obfuscated at rest, and shown only as dots and its last four characters. To keep it out of the database, define it in wp-config.php instead:
define( 'FORMSIEVE_API_KEY', 'FS-XXXX-XXXX-XXXX-XXXX' );
The constant wins over a saved key. One key serves every site your plan covers (Sites and agencies). The constants of the two earlier plugins, FSV_GF_API_KEY and FSV_CF7_API_KEY, are still read until version 1.2.0, with a notice asking you to rename them.
What is sent. (After the one-click trial this step and the next are done already.) Formsieve sends nothing until an administrator opts in. The consent screen lists exactly which data is sent, to which companies (Thinking42, which runs Formsieve's service, and its sub-processors OpenRouter and TypeSafe AI, Inc.), in which country, with links to the Terms, the Data Processing Agreement and the privacy policy. Tick the box to agree. You can withdraw consent at any time on the plugin's Privacy tab; nothing is sent after that.
Test connection. One real call with a canned spam sample, sent only after you have given consent. It does not count as an AI check (20 tests a day per key, 5 on the Free plan, as of 2026-09-29). The result shows:
- your plan and status, this month's AI checks and allowance, and whether this site has a slot on the plan;
- the model that answered and its calibration status (Calibrated or Unrecognized, explained in Calibration);
- the request ID and the latency;
- the verdict and spam probability for the sample.
Nothing is sent automatically: the call runs only when you click the button.
3. Describe your site
Under Settings → Detection:
- What this site does: one or two sentences about what you do and what visitors use your forms for. Example: "Web design agency in Miami. Visitors ask for quotes, ask about our services or request support for existing projects." This helps Jev tell a real enquiry from a sales pitch.
- Languages visitors write in: language codes such as
en, es(empty: the site language). - Preset (under Sensitivity): Low, Medium (default) or High. See Verdict bands and actions.
Then open each form's Formsieve settings if a form needs its own context, threshold or excluded fields: Per-form settings for Gravity Forms, Per-form settings for Contact Form 7. Settings → Forms lists every form of both form plugins, with its form plugin, its decisions over the last 30 days and a link to its Formsieve settings.
4. Check it works
Submit a test message on a live form from a logged-out (private) browser window, then open the entry under Forms → Entries (Gravity Forms), Flamingo → Inbound Messages (Contact Form 7, if Flamingo is installed) or Formsieve's Log tab. You should see the verdict, the probability and the request ID, and the dashboard counts it.
Test mode
Test mode (Settings → Advanced) returns simulated verdicts from recorded examples for every submission, runs the full decision path, and sends nothing; you need no key and no consent. A red Test mode badge shows in the admin bar while it is on, and log rows are marked as demo. Use it to try the plugin, to show it to a client, or to review it without a key.
To see each verdict, submit a form from a logged-out (private) browser window, because trusted logged-in users are allowed without a check, and put one of these markers anywhere in the message:
| Marker | Simulated result |
|---|---|
[fsv:spam] |
Block (vendor solicitation, 97%) |
[fsv:review] |
Review band (62%) |
[fsv:ham] |
Allow |
[fsv:inject] |
A prompt-injection attempt: the probability is forced to 90%, so it is blocked with the Medium or High preset and goes to the review band with Low (block threshold 92%) |
Only what the visitor typed is looked at (not your site or form descriptions). Without a marker, words such as "SEO" or "backlinks" produce a spam verdict, "guest post" or "partnership" a review verdict, and anything else is allowed. The pre-filters stay active: wait a few seconds before submitting (faster than 3 seconds counts as a bot), and expect the rate limit after 5 submissions in 10 minutes from one IP address.
Turn Test mode off before relying on Formsieve for real submissions. While it is on, a simulated spam verdict on a Gravity Forms form is saved as spam even when the form is set to discard spam or refuse it with a validation error, so a real submission can be restored from Entries → Spam.