Title: FlatLineForm – Contact Form 7 Monitoring
Author: flatlineform
Published: <strong>November 17, 2026</strong>
Last modified: November 17, 2026

---

Search plugins

![](https://ps.w.org/flatlineform/assets/banner-772x250.png?rev=3808193)

![](https://ps.w.org/flatlineform/assets/icon.svg?rev=3808193)

# FlatLineForm – Contact Form 7 Monitoring

 By [flatlineform](https://profiles.wordpress.org/flatlineform/)

[Download](https://downloads.wordpress.org/plugin/flatlineform.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/flatlineform/#description)
 * [Reviews](https://wordpress.org/plugins/flatlineform/#reviews)
 *  [Installation](https://wordpress.org/plugins/flatlineform/#installation)
 * [Development](https://wordpress.org/plugins/flatlineform/#developers)

 [Support](https://wordpress.org/support/plugin/flatlineform/)

## Description

A broken contact form shows no error to you. After an update, a changed mail setting
or an expired SMTP login, visitors may still see “Thank you for your message” while
no email reaches you, and you find out when someone asks why nobody replied.

Until then, every enquiry is lost: quote requests, bookings, job applications. Paid
ads keep sending visitors to a form that does nothing, and customers who never heard
back assume you ignored them. Site owners in the Contact Form 7 support forum describe
forms that had not sent a single email for months.

FlatLineForm tests your form once a day, the way a visitor uses it, and emails you
when something fails:

 * the page or the form did not load,
 * the form rejected the test or never answered (the button that just spins),
 * WordPress could not send the email (“There was an error trying to send your message”),
 * WordPress reported the email as sent, but our copy of it never arrived.

Each step is reported separately, so a thank-you message is never mistaken for a
delivered email. You sign up at https://flatlineform.com, free during the launch
period. No check can catch every fault, but a daily one means you are not the last
to know.

#### How it works

FlatLineForm is the WordPress side of the FlatLineForm monitoring service. The service
opens your form pages in a real browser, fills in clearly labelled test data and
submits the form, the same way a visitor would. This plugin lets the service:

 * see which Contact Form 7 forms exist, which fields they have and which published
   pages show them,
 * report the WordPress, PHP and Contact Form 7 versions and whether they are compatible,
 * prepare short-lived, signed test runs,
 * learn what happened to a test submission: the Contact Form 7 result and whether
   WordPress reported that the mail function succeeded.

Only submissions that carry a valid, signed and unexpired test marker (a cookie 
set by the service’s browser) are treated as tests. Every test run can be used exactly
once. Ordinary visitors are not affected in any way.

During a test run the plugin adds a blind copy (Bcc) of the form’s primary email
to a test address owned by the service, plus an `X-FlatLineForm-Run` header. This
lets the service confirm that the test copy arrived. The copy is added only to the
test submission, never to real messages.

Please note what the checks can and cannot prove. A “thank you” message on the page
does not prove that email was delivered. That WordPress reports a successful mail
call does not prove that your inbox received the message. A received test copy only
proves that the copy arrived.

The plugin:

 * does nothing until an administrator enters a connection code under Tools  FlatLineForm,
 * adds nothing to the public site (no links, scripts, styles or advertising),
 * never stores or forwards the content of form messages or visitor details,
 * does not modify Contact Form 7 or any other plugin (the optional CAPTCHA exemption
   only removes Contact Form 7’s own reCAPTCHA/Turnstile check during a valid test
   request, through Contact Form 7’s documented `wpcf7_spam` filter).

Limitations: forms with file uploads, multi-step or payment fields are reported 
as not supported. Forms protected by CAPTCHA, quiz, reCAPTCHA or Turnstile are checked
up to the send button and reported as blocked, because an automated test cannot 
solve them.

Optional CAPTCHA exemption for tests: on the Tools  FlatLineForm page an administrator
can let signed test messages skip Contact Form 7’s built-in reCAPTCHA and Turnstile
checks. It is off by default. When it is on, the check is removed for one request
at a time, and only for a submission that carries a valid, signed, single-use test
marker for that form. Everyone else, including bots, still has to pass the CAPTCHA,
and other spam filters such as Akismet still run. Results of such tests say that
the CAPTCHA was skipped and not tested. CAPTCHA plugins from other vendors are not
affected.

This plugin has not been reviewed or approved by WordPress.org.

### External services

This plugin connects to the FlatLineForm service. The service address is entered
by the administrator on the Tools  FlatLineForm page (or set with the `FLATLINEFORM_SERVICE_URL`
constant). Nothing is sent before an administrator connects the site.

What is sent, and when:

 * **When an administrator clicks “Connect”**: the one-time connection code, the
   site’s home URL, and the plugin, WordPress, PHP and Contact Form 7 versions are
   sent to `<service>/api/plugin/connect`.
 * **When an administrator clicks “Rotate keys”**: a signed request to `<service
   >/api/plugin/rotate` and `<service>/api/plugin/rotate/confirm`, containing only
   a rotation id.
 * **When an administrator clicks “Disconnect”**: a signed request to `<service>/
   api/plugin/disconnect` with an empty body.

After the site is connected, the service calls this site’s REST API (namespace `
flatlineform/v1`) with signed requests. The plugin answers with versions and compatibility,
the list of Contact Form 7 forms (id, title, field names, field types and options,
defined choices for select/radio/checkbox/acceptance fields, and the URLs and titles
of published pages that show each form), and the status of test runs (status codes
and timestamps only).

During a test run, the test submission’s primary email is also sent as a blind copy
to a test address owned by the service. That test submission contains only synthetic
test data entered by the service’s browser.

The plugin never sends real form submissions, visitor data or email addresses of
your visitors to the service.

Terms of use and privacy policy of the service (here `<service>` is the service 
address you connect to; the same links are shown on the Tools  FlatLineForm page):

 * Terms of use: `<service>/terms`
 * Privacy policy: `<service>/privacy`

## Installation

 1. Upload the `flatlineform` folder to `/wp-content/plugins/`, or install the ZIP 
    file under Plugins  Add New  Upload Plugin.
 2. Activate the plugin. Activation does not contact any external service.
 3. Make sure Contact Form 7 is active.
 4. In the FlatLineForm service, add your site and create a connection code.
 5. Go to Tools  FlatLineForm, enter the code (and the service address), and click 
    Connect.

## FAQ

### My form says the message was sent, but no email arrives. Will FlatLineForm catch that?

Yes, as far as it can be seen from outside your inbox. The plugin adds a hidden 
copy of each test email to an address of ours, so the service can tell whether WordPress
only reported the email as sent or whether it actually left your site. Whether it
then landed in your inbox or your spam folder is something only you can see; you
confirm that step yourself.

### Contact Form 7 stopped working after an update. How would I find out?

From the next daily check. A problem found before the form was sent is checked again
after 10 minutes, and you get an email if it is still there. A problem after the
form was sent is reported at once.

### Will the test messages bother anyone?

Once a day, one test message goes through your form to the form’s normal recipient,
like a real enquiry. It is clearly labelled as an automated test enabled by the 
site owner and includes a check id, so it is easy to filter. You can pause at any
time.

### Do I need an account? Is it free?

Yes, you need an account at https://flatlineform.com. The service is free during
the launch period; paid plans may come later and you will be told in advance. The
plugin itself has no locked features.

### Does the plugin change how my forms behave for visitors?

No. Without a valid test marker the plugin does nothing. With an invalid, expired
or already used test marker the submission is not mailed and is not recorded.

### What happens when I uninstall the plugin?

The plugin’s own database tables, options and scheduled event are removed. Contact
Form 7 and your forms are not touched.

### Does the plugin store form messages?

No. For each test run it stores only the run id, form id, the test copy address,
status codes and timestamps. Test run records are deleted after 7 days.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“FlatLineForm – Contact Form 7 Monitoring” is open source software. The following
people have contributed to this plugin.

Contributors

 *   [ flatlineform ](https://profiles.wordpress.org/flatlineform/)

[Translate “FlatLineForm – Contact Form 7 Monitoring” into your language.](https://translate.wordpress.org/projects/wp-plugins/flatlineform)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/flatlineform/), check
out the [SVN repository](https://plugins.svn.wordpress.org/flatlineform/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/flatlineform/) by
[RSS](https://plugins.trac.wordpress.org/log/flatlineform/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1.0

 * Optional setting that lets signed test messages skip Contact Form 7’s built-in
   reCAPTCHA and Turnstile checks (off by default). Results report when the CAPTCHA
   was skipped.

#### 1.0.0

 * First version.

## Meta

 *  Version **1.1.0**
 *  Last updated **8 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [contact form](https://wordpress.org/plugins/tags/contact-form/)[contact form 7](https://wordpress.org/plugins/tags/contact-form-7/)
   [email](https://wordpress.org/plugins/tags/email/)[monitoring](https://wordpress.org/plugins/tags/monitoring/)
   [testing](https://wordpress.org/plugins/tags/testing/)
 *  [Advanced View](https://wordpress.org/plugins/flatlineform/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/flatlineform/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/flatlineform/reviews/)

## Contributors

 *   [ flatlineform ](https://profiles.wordpress.org/flatlineform/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/flatlineform/)