WordPress plugin
Testomato Monitoring is the official WordPress plugin. It connects your WordPress or WooCommerce site to Testomato in about thirty seconds — you enter an email address, the plugin creates your account and a project for the site, and a widget on your WordPress dashboard shows the current status.
The checks themselves never run on your server. Testomato tests your site from its own machines in nine locations, which is why the alert still arrives when WordPress, PHP or the whole host is down.
Requirements
Section titled “Requirements”| Requirement | Notes |
|---|---|
| WordPress | 5.8 or newer (tested up to 6.9) |
| PHP | 7.4 or newer |
| WooCommerce | Optional — detected automatically when active |
| Testomato account | Created by the plugin; a 14-day free trial, no credit card |
Installation
Section titled “Installation”- In your WordPress admin go to Plugins → Add New and search for Testomato Monitoring. Alternatively, download the ZIP from wordpress.org and upload it under Plugins → Add New → Upload Plugin.
- Click Install Now, then Activate.
- Go to Settings → Testomato Monitoring.
Connecting your site
Section titled “Connecting your site”
- The Your email field is pre-filled with your WordPress administration email. Change it if you want the Testomato account to live under a different address.
- Click Connect.
- If the address is not signed in to Testomato yet, a One-time code field appears and we email you a code. Paste it in and click Connect again.
- The page reloads with the connected view.
That is the whole setup. There is no API key to copy and no password to store — sign-in to Testomato is by one-time code.
What happens when you connect
Section titled “What happens when you connect”- A Testomato account is created for the email address you entered (or the existing one is used).
- A project is created for this site's home URL.
- Testomato reads your homepage and suggests the key pages worth monitoring; those URLs are added to the project as tests.
- When WooCommerce is active, the cart and checkout URLs are added as well.
- Uptime monitoring and SSL certificate monitoring are enabled for the project.
Already have a Testomato account?
Section titled “Already have a Testomato account?”The connect flow always creates a new Testomato account, so it cannot attach the site to an account that already exists. Entering an address that is already registered stops the flow with an "already taken" error.
If you are already a Testomato customer, you have two options:
- add the site as a new project directly in your Testomato dashboard — the plugin is not needed for monitoring, only for the WordPress dashboard widget;
- or connect the plugin with a different email address, which gives this site its own account and trial.
The connected settings page
Section titled “The connected settings page”
Once the site is connected, Settings → Testomato Monitoring shows:
- Open Testomato dashboard — a one-click link that signs you in to your Testomato project without a password.
- What we monitor — a summary of what the project checks.
- Disconnect — see Disconnecting below.
The dashboard widget
Section titled “The dashboard widget”
The plugin adds a Testomato Monitor widget to the main WordPress dashboard. It shows:
- Overall status — green when every check passes, yellow for a warning such as a timeout, red when something failed, together with the number of healthy checks.
- 7-day uptime — the uptime percentage plus one coloured bar per day, so an incident from earlier in the week is still visible.
- 24-hour response time — an interactive trend line with the average response time over the last day.
- Trial countdown — how many days of the free trial are left, and a link to the plans once it ends.
- Refresh — re-fetches the status immediately instead of waiting for the cached value to expire.
Status values are cached for a few minutes so that opening the dashboard never waits on a network round trip. The charts are drawn with a copy of Chart.js bundled inside the plugin — no CDN is contacted from your admin.
If you don't want the widget, use the Screen Options menu at the top of the WordPress dashboard and untick Testomato Monitor.
Changing what is monitored
Section titled “Changing what is monitored”The plugin bootstraps the project; everything after that is managed in Testomato. Click Open Testomato dashboard and you can:
- add or remove monitored URLs, including pages behind a login;
- define the text, HTML, headers or structured data that must be present on a page — see Checks;
- set response-time thresholds and the check interval;
- choose where alerts go — email, Slack, webhooks and the other notification channels;
- invite colleagues to the project.
Changes made in the dashboard are not written back to WordPress. The plugin reads status only.
Disconnecting the site
Section titled “Disconnecting the site”Go to Settings → Testomato Monitoring and click Disconnect.
This removes the stored tokens from this WordPress installation. Your Testomato project is not deleted — it stays in your account with its full history and keeps monitoring the site. To stop monitoring entirely, delete the project in the Testomato dashboard as well.
Deleting the plugin removes every option it created (all testomato_monitor_* options and the cached status values). Deactivating alone leaves them in place, so you can reactivate without connecting again.
What the plugin sends to Testomato
Section titled “What the plugin sends to Testomato”The plugin contacts the Testomato API at https://testomato.com/api and sends:
| When | What |
|---|---|
| You click Connect | The email address you entered, so we can email you a one-time sign-in code. |
| You submit the code | The code, the email address, the WordPress administrator's first and last name (from your WordPress profile, falling back to the site name), and the site's home URL. |
| While setting up | Your site's public home URL, so the test suggestion service can propose pages to monitor. |
| While connected | The project ID, to read the current status shown in the dashboard widget. |
No content of your posts, users, comments or media is ever sent. Testomato then crawls the public pages of your site from its own servers, the same way a search-engine crawler does — see TestomatoBot.
The tokens returned by the API are stored in the WordPress options table under the testomato_monitor_ prefix.
Service terms: testomato.com/terms-of-service · Privacy policy: testomato.com/privacy-policy
Troubleshooting
Section titled “Troubleshooting”Connect fails because the site is not reachable
Section titled “Connect fails because the site is not reachable”Testomato validates the URL by fetching it before creating the project, so the site must be reachable from the public internet. A site on localhost, on a private IP range, behind basic auth or behind a firewall that blocks unknown crawlers cannot be connected. Allow TestomatoBot through and try again.
Connect fails with an "already taken" error
Section titled “Connect fails with an "already taken" error”The email address is already registered with Testomato, and the connect flow can only create a new account. Use an address that is not registered yet, or add the site as a project from the account that owns that address — see Already have a Testomato account? above.
The one-time code never arrives
Section titled “The one-time code never arrives”Check the spam folder first. The code is sent to the exact address in the Your email field, which may differ from the address you expected if your WordPress administration email was changed. Codes are short-lived; click Connect again to get a new one.
The widget shows "no data yet"
Section titled “The widget shows "no data yet"”The first check results need a few minutes to appear after connecting. If the widget is still empty after ten minutes, open the Testomato dashboard and confirm the project has tests and that uptime monitoring is enabled — see Uptime monitoring.
The widget reports a problem but the site looks fine
Section titled “The widget reports a problem but the site looks fine”Testomato tests from outside your network, so it sees what an external visitor sees — including latency, geo-blocking and rate limiting that never affect you locally. Why does Testomato say my site is down when it's not? covers the usual causes.
The status is stale
Section titled “The status is stale”Status is cached for a few minutes. Use the refresh button in the widget to fetch it immediately.
Getting help
Section titled “Getting help”Write to support@testomato.com with your site URL and, if the problem is in the connect flow, the exact error message from the settings page. See also Support.