formsieve Docs Support
All docs pages

Getting a Formsieve key

Formsieve's AI check runs on Formsieve's own service, run by Thinking42. To use it, your site needs a Formsieve key (it looks like FS-XXXX-XXXX-XXXX-XXXX). The AI is included: you do not need an account with TypeSafe, OpenRouter or any other AI provider.

One key turns on the AI check for Gravity Forms and Contact Form 7 forms, on every site your plan covers. Without a key, the plugin's free local filters still run on every submission (see Pre-filters).

Start a free trial

From the plugin, in one click (version 1.2.0 and later). Install Formsieve and open it: the setup wizard's first card, and Settings → Connection while no key is saved, is Start your free trial. Check the e-mail address (it is filled in with yours), read what is sent, tick the box and click Start free trial and connect. The plugin creates your Formsieve account and trial key on formsieve.com, saves the key, records your consent and runs Test connection, so the AI check is on at once. We e-mail you that the trial has started, with a link to sign in to your account. Nothing is sent before you click.

To create the trial the plugin sends formsieve.com, once: the e-mail address you entered, the 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 ticked with the names of the documents it accepts (the Terms, the Privacy policy and the Data Processing Agreement). No form data. The trial from the plugin is for live sites; on a local, development or staging address, use formsieve.com.

On formsieve.com. The way to go for a local or staging site, or if you prefer:

  1. Go to https://formsieve.com/start/ and enter your e-mail address.
  2. Enter the 6-digit code we e-mail you. Your trial key appears on the screen, with the set-up steps.
  3. Paste the key in the plugin (Connect your site).

If the plugin says an address already has a Formsieve account, sign in at https://formsieve.com/account/ with that address (we e-mail it a sign-in link too) and copy your key from there.

The trial lasts 14 days or 500 AI checks, whichever comes first, and needs no card (as of 2026-09-25). There is one trial per e-mail address and one per site. When it ends, nothing is charged: your key moves to the Free plan, 100 AI checks a month for one production site (as of 2026-09-27). AI checks pause when those are used, and your forms keep working with the local filters. If you subscribe, the trial key becomes your paid key, so there is nothing to change on your sites.

Choose a plan

Plans differ in the number of sites and the number of AI checks a month, shared by all your sites. See https://formsieve.com/pricing/ for current prices, and Plans, AI checks and limits for what counts and what happens at the limit.

You can subscribe from the pricing page, or from your account during the trial. Payment happens on Stripe's secure checkout. Your key is shown on the welcome page and in your account at https://formsieve.com/account/. For your security it is never e-mailed in full.

Connect your site

  1. Install Formsieve from WordPress.org (Installing from WordPress.org).
  2. Open Formsieve in the WordPress admin. The set-up wizard starts.
  3. Formsieve key: no key yet? Use Start free trial and connect (Start a free trial); steps 4 and 5 then happen by themselves. With a key, paste it under I already have a key. (The links there open the trial page and your account in a new tab; nothing is sent in the background.)
  4. Consent: read which companies receive data, what is sent and what is never sent, then tick "I agree to the Formsieve Terms and Data Processing Agreement" and the lawful-basis box. Nothing leaves your site before this step (Privacy kit).
  5. Test connection: Formsieve checks the key and sends one canned sample. It shows your plan, this month's usage and this site's status: "Registered", "Staging site: does not use a site slot", or "Your plan's sites are in use: remove one in your account". The Free plan covers one production site, so the AI check is off on development and staging sites (as of 2026-09-29).

You can choose Skip for now at any step. The local filters work without a key.

Put the key in wp-config.php

Instead of pasting the key in each site's settings, you can define it in wp-config.php:

define( 'FORMSIEVE_API_KEY', 'FS-XXXX-XXXX-XXXX-XXXX' );

The constants of the two earlier plugins, FSV_GF_API_KEY and FSV_CF7_API_KEY, are still read until version 1.2.0 (as of 2026-09-26); rename them to FORMSIEVE_API_KEY. A key defined in wp-config.php applies to every site of a multisite network. The settings screen then shows the key as set in wp-config.php and does not let you change it there.

Agencies and several sites

  • Sites: each production site address uses one site slot. Staging, development and local sites (for example *.test, *.local, localhost, or addresses starting with staging. or dev.) do not use a slot, but their AI checks count. The Free plan covers one production site. Staging and development sites need a paid plan (as of 2026-09-29). See Plans, AI checks and limits.
  • One key for client sites: the Agency and Scale plans cover unlimited production sites that you own or build and maintain for clients (fair use). Hosting companies need a Custom plan.
  • See and remove sites: your account's Sites page lists each site with its checks this month and when it was last seen. Remove frees the slot at once.
  • Separate keys per client that share one allowance are planned for a later release (as of 2026-09-26).

Rotate your key

If a key may have leaked, or someone who had it leaves, go to your account → Key → Rotate key. You get a new key at once. The old key keeps working for 24 hours, so you have time to update your sites, and then stops. We confirm the rotation by e-mail.

Keep the key private: do not share it, commit it to a public repository or put it in browser code (the service refuses requests from browsers).

After you have a key

Run Test connection whenever you change the key. If something is wrong, it says whether the key is invalid, the plan is not active, the site is not on your plan, or the month's checks are paused, with a link to your account. See Troubleshooting.

Upgrading from 1.0

Version 1.0 used your own AI provider key (TypeSafe, Vercel AI Gateway, OpenRouter or a custom proxy) and, for downloads from formsieve.com, a separate licence. Version 1.1.0 removes both: when it updates, it clears the old provider route and key and the licence, keeps every other setting (detection, lists, forms and privacy), and asks you to connect a Formsieve key.