Description
Rehearsr checks your pages after plugin, theme and WordPress updates, compares them with how they looked before, and shows you what changed. Everything runs on your own server. No account, no paid service, no tracking.
It works the moment you activate it. It finds your public pages, picks the important ones, and records a first baseline in the background. After the next update, it checks the same pages again and tells you what broke.
Why use Rehearsr
- Catch problems before your visitors do. An update can break a menu, a form or a whole page without any error message. Rehearsr checks for you right after the update.
- No setup needed. Activate it and the first check starts on its own.
- Private by design. Every check runs on your own server. No account, no API key, no data sent to anyone.
- Clear results. One screen tells you if every check passed, or which pages need you.
- Steps to fix it. Every problem comes with simple “How to fix this” steps, written for site owners, not only developers.
- Safe for live sites. Rehearsr only reads your pages. It never fixes, changes or deletes anything.
- Free. All features are included, with no paid upgrade.
How it works
- It picks your pages. Rehearsr finds your public pages and selects the important ones. You can change the list at any time.
- It records a baseline. A baseline is a saved copy of how each page looks and works today.
- It checks after every update. After a plugin, theme or WordPress update, the same pages are checked again and compared with the baseline.
- It shows you what changed. Passed, warning, needs review or failed, with the evidence for each page.
Checks that work without any extra setup (PHP checks)
- Finds your public pages and selects them for you, and you can change the selection
- Status codes, redirects and response time
- Broken CSS, JavaScript and images
- Page structure compared with your baseline, so it notices a missing heading, form or menu, a big drop in text, or a plugin’s files that stopped loading
- Runs after plugin, theme and WordPress updates, daily, or when you ask
- Reads the PHP error log when your host allows it
- Read-only WooCommerce storefront checks
- Optional email alerts for new problems
Extra checks with the optional browser runner (included in the plugin)
- Full-page screenshots at desktop, tablet and mobile sizes
- Visual comparison with side by side, overlay and difference views
- JavaScript errors, console errors and failed requests
- Overflow checks at each screen size
- Functional tests that click through a page
The runner is free software you host yourself. It runs with Docker, Node.js or a free GitHub Actions schedule.
Screens inside Rehearsr
- Overview: the result of the last check, open issues and recent updates
- Run scan: choose a quick scan, a full scan, a post-update scan or a baseline capture
- Pages: choose which pages are tested and how important each one is
- Broken pages: server errors, redirects, broken files and content changes
- History: every scan, with the result for each page
- Baselines: the approved record of each page
- Reports: HTML or JSON reports you can send to a client
- Settings: schedule, scan limits, alerts, data storage and the optional screenshots set-up
After you connect the optional browser runner, three more screens appear:
- Visual: screenshot comparisons you can approve or reject
- Browser errors: console errors, failed files and layout overflow
- Tests: short scripts that click through a page like a visitor
Who is it for
- Site owners who update plugins and want to know nothing broke
- Agencies and freelancers who look after client sites
- WooCommerce stores that cannot afford a broken shop page
- Developers who want a simple regression check without a paid service
Rehearsr reports evidence. It cannot detect every possible problem, and it never fixes or changes your site.
Feedback and support
- Found a problem or have a question? Post in the support forum.
- Have an idea for a feature? Send it through the plugin feedback form.
- Is Rehearsr useful to you? A short review helps other site owners find it.
External services
This plugin contacts no third-party service. It sends requests only to your own site. The optional browser runner is software you install and host yourself, on your own server, computer or GitHub account. It connects to your site, and your site does not send data to anyone else.
The plugin screens include links to the WordPress.org support forum, the WordPress.org review form and a feedback form on siteaudithub.com. These are plain links that open only when you click them. Nothing is sent automatically.
Third-party resources
- Schibsted Grotesk font, bundled in
admin/fonts/, by The Schibsted-Grotesk Project Authors. Licensed under the SIL Open Font License 1.1 (seeadmin/fonts/OFL.txt). Source: https://github.com/schibsted/schibsted-grotesk - The optional browser runner (in the
runnerfolder) runs outside WordPress. When you install it, npm downloads Playwright (Apache-2.0), pixelmatch (ISC) and pngjs (MIT). It is never run by the plugin itself.
Installation
- Upload the plugin and activate it. Your pages are found and a first check runs in the background.
- Open Rehearsr to see the result. Use Pages to choose which pages matter most.
- From now on, every update is followed by a check of those pages.
For screenshots and JavaScript checks, open Rehearsr, then Settings, and click “Set up screenshots”. Create a key and download the runner. It runs with Docker, Node.js or a free GitHub Actions schedule.
Quiet sites should use a real system cron, because WP-Cron only runs when someone visits. For example: wp rehearsr tick every minute.
On Nginx, .htaccess has no effect. Screenshot folders use a long random name and are only served through a logged-in admin check, but you should also deny access to wp-content/uploads/rehearsr-*.
FAQ
Do I need to set anything up?
No. On activation the plugin finds your pages, selects your home page and up to your page limit of other pages, and records the first baseline. You can change the selection on the Pages screen at any time.
Does Rehearsr tell me how to fix a problem?
Yes. Every problem on the Overview, Broken pages and History screens has a “How to fix this” box with simple steps, such as which setting to check or what to try first. When something breaks right after an update, the scan also shows the safest first steps, like rolling back the plugin you just updated. Rehearsr never changes your site by itself.
What is a baseline?
A baseline is a saved record of how a page looks and works when you know it is fine. Every later scan is compared with it. Scans never replace a baseline on their own. You approve a new one when a change is intended.
Do I need the browser runner?
No. The PHP checks work on any host without it. The runner only adds screenshots, visual comparison, JavaScript errors and functional tests. Until you set it up, the screens and scan types that need it stay hidden, so the menu only shows what you can use. You can set it up at any time from Settings.
Does it slow down my site for visitors?
No code from this plugin runs on public pages beyond registering two update hooks. It adds no CSS, no JavaScript and no database queries to the front end. Checks run in small background batches.
Does it work on multisite?
Yes. You can activate it on single sites or network-wide. Each site keeps its own pages, scans, settings and tables. After a network-wide activation, the first page list and baseline scan for each site start the first time an administrator opens that site’s dashboard. Sites added later are set up automatically, and their tables are removed when a site is deleted.
Will it place orders or submit forms?
No. WooCommerce checks are read-only. In functional tests, steps that look like purchases or form submissions are refused when you save the test, and the browser runner blocks every request that would send data to your site (POST, PUT, DELETE). Only a test you mark as running on a sandbox site may submit forms.
Where are screenshots stored, and how much space do they use?
Screenshots are saved in a folder inside wp-content/uploads with a long random name, and are only shown to logged-in administrators. Old scans are removed after 30 days by default. You can change this under Settings, and the Settings screen shows how much space is in use.
What happens to my data when I delete the plugin?
By default, your scans and settings are kept, in case you install Rehearsr again. If you want everything removed, turn on “Delete all plugin data when the plugin is deleted” under Settings before you delete the plugin.
Where can I report a problem or suggest a feature?
Use the support forum on this plugin’s page, or send a suggestion through the plugin feedback form.
Changelog
1.0.1
- New: modern design for every Rehearsr screen, with colours that match the Rehearsr logo, in light and dark mode.
- New: the Rehearsr logo in the header of every screen.
- New: an icon next to each screen title, and the menu split into three groups: getting started, results and setup.
- New: smooth animations: cards fade in, numbers count up, buttons and cards react on hover. Animations turn off when your system asks for less motion.
- New: a three step guide on the Pages screen.
- New: custom drop-downs, checkboxes and fields that are easy to read in light and dark mode.
- New: screens and scan types that need the browser runner stay hidden until a runner has connected. The runner set-up moved under Settings, as an optional step.
- New: a “How to fix this” box under every problem, with simple steps for more than 40 kinds of problems, and first steps to try when something breaks right after an update.
- Fixed: drop-down text became invisible on hover in dark mode.
- Fixed: after an update, browsers could keep showing the old Rehearsr design until the cache was cleared.
- New: “How Rehearsr works” guide and a short explanation under each number on the Overview screen.
- New: a short description at the top of the History and Settings screens.
- New: Leave a review and Send a suggestion links in the Rehearsr header, at the bottom of every screen and on the Plugins screen.
- New: Dashboard link on the Plugins screen.
- Improved: readme with more detail on features, screens and common questions.
1.0.0
- First release.
