You run your client sites from MainWP and want to know what each part of the WebChange Detector add-on does. This page walks through every screen of the add-on: the four tabs of the add-on page, then the places where it shows up elsewhere in MainWP. For each setting it says what it does and when you would change it.
It’s a reference, not a how-to. Each section links to the tutorial that explains the job step by step. New to the add-on? Start with Start with MainWP. You don’t have it yet? Get it from wordpress.org.
Where the add-on shows up in MainWP
- The add-on page with four tabs: Run 1, Checks, Settings and Account. Until an account is connected it opens on Account; after that on Run, where Run visual checks & updates 2 starts a WCD Update.
- A bar on the MainWP Updates page, to install updates together with visual checks.
- A “WebChange Detector: Updates” widget on the MainWP dashboard and on the overview of each child site.
- A WebChange Detector tab on each child site.
- A notice “Set up WebChange Detector to start visual checks” with Open settings, as long as no account is connected.
Account tab
This tab connects the MainWP dashboard to your WebChange Detector account. One dashboard uses one account.
Create an account or connect one
- Create your account on the Account tab 1: First name, Last name, Email address and Password, then Create account 2. The tab then shows Activate your account: click the link in the email and use Reload this page. Until you did, the other tabs stay hidden.
- Already have an account?: paste your token into WebChange Detector API Token 3 and click Save & verify. You find the token on the Dashboard of the Web App under Show API Token.
Step by step: Connect your account.
Once connected
- Plan, Checks available and Active sites 1: your plan, how many checks are left in this period and how many MainWP sites are activated for visual checks.
- WebChange Detector API Token 2: the token this dashboard is connected with, shown as dots.
- Auto-enable new sites 3: on by default. Every site you add to MainWP later is activated for visual checks and gets its pages synced. Untick it and save if you prefer to activate each site by hand.
- Save & verify: stores the token and the option, and tests the token right away.
- Reset connection 4: disconnects this MainWP dashboard from your account and forgets which sites were activated. Your websites and checks at WebChange Detector are not deleted; enter the token again to reconnect. Use it to move the dashboard to another account.
Settings tab
Under Sites & pages you see every site MainWP manages. Activating a site costs nothing: websites are not limited, only the checks you run count.
- The switch in front of a site 1: activates the site for visual checks. Sites that are off show Inactive and are updated without checks.
- Activate checks for all websites: switches all sites on in one go. Use it when every client should be covered.
- Configure URLs: opens the page list of the site. Switch each page on or off for Desktop and Mobile, use Search URLs… to find one, and Select all to switch a whole device. One page on one device is one check per run.
- Settings 2: opens On-Demand check settings for the site.
Step by step: Activate your sites and Choose the pages.
On-Demand check settings of a site
These settings apply to the checks that run when you update this site from MainWP.
- Screenshot region: Auto-Detect, United States (US) or Europe (EU). Pick a fixed region when the site shows different content per country, or when the data should stay in one region.
- Activate newly synced URLs by default: with Desktop or Mobile ticked, pages found by a later sync are selected right away. Leave it off to keep your number of checks under control.
- Difference threshold: differences below this percentage are not reported.
- Alert emails: these addresses get an email when a check finds a change. Several addresses are separated by commas; empty means no email.
Under Advanced settings:
- Basic Auth username and Basic Auth password: for a site behind a browser password prompt, such as a staging site. Clear the password field to remove a stored password.
- Use static IP proxy: our screenshots come from one fixed IP address, so the site’s firewall can allow it.
- Screenshot delay (seconds): the pause between the starts of two screenshots. The default is 10, and you can raise it up to 60. Raise it when the server struggles with many page loads in a row. Leave it blank to keep the current value.
- CSS injection: CSS applied before each screenshot, for example to hide a banner that changes on every visit.
- JavaScript injection: JavaScript that runs before each screenshot, for example to close a popup.
Save settings stores them. When to use which: Fine-tune a site and My Check Shows Changes I Do Not Care About.
Run tab and the WCD Updates flow
The Run tab lists the Sites with updates, with the Pages to check and the Checks needed for each. Run visual checks & updates starts WCD Updates: screenshots before, all updates, screenshots after, comparison.
The window before the run
Pre-update visual check shows what is about to happen before anything starts.
- Sites, Pages and Checks, split into Desktop and Mobile.
- “This run uses … checks” next to the checks you have available, marked Enough credits 1 or with the number you are short. When you are short, the run can’t start and Upgrade plan opens the pricing page.
- The updates that will be installed per site (core, plugins and themes).
- Capture & update starts the run, Cancel closes the window.
While it runs
The run card moves through Pre, Updates, Post and Done, and shows per site whether it is queued, capturing, installing or comparing. Your sites stay live the whole time; only screenshots are taken. Keep the browser tab open until the run finishes. If you reload or close it by accident, the run is picked up again.
At the end each site says All good or how many pages are left to review, with View results and Re-check. A failed site is marked Failed.
Step by step: How to Run WCD Updates with Visual Checks in MainWP, and what to do after an interruption: Resume a run.
Checks tab
Every run you started from MainWP, newest first, with Websites, Status, Created and an AI Summary in plain words.
- Date range: Last 7 days, Last 30 days, Last 90 days, All time or Custom range with From and To.
- All statuses: limit the list to New, OK, To Fix or False positive.
- All websites: limit it to one site.
- All detections or With changes only.
- Filter applies your choice, Reset clears it.
Open a run to see its pages: URL, Compared (the Before and After time), Visual change, AI summary and the status. View opens the comparison with the slider and the AI analysis in WebChange Detector. To change its status, log in there.
Step by step: Review the results. How to read a comparison: How to Review Checks.
The bar on the MainWP Updates page
On MainWP’s own Updates page the add-on adds a bar, “Update with before/after visual checks.” It has two buttons 1:
- Update Selected with Checks: runs WCD Updates for the updates you ticked.
- Update All with Checks: runs it for everything that is pending.
Both open the same window before the run as the Run tab. Sites that are not activated are marked “Checks not activated” and would be updated without checks.
The widget on the MainWP dashboard
WebChange Detector: Updates lists the sites with pending updates, the pages to check and the checks needed, with the button Run visual checks & updates. On the overview of a single child site it shows that site only. If the site is not activated yet, the widget links to the Settings tab instead.
The WebChange Detector tab of a child site
Open a child site in MainWP and choose the WebChange Detector tab.
- Update with Checks: runs WCD Updates for this one site.
- Configure URLs: opens the page list of the site.
- “No updates available for this site right now.” means there is nothing to install.
If the site is not activated, the tab links to the Settings tab.
Good to know
- Monitoring and Auto Update Checks are not set in the add-on. Monitoring is set up in the Web App; in MainWP, WCD Updates take the place of Auto Update Checks.
- Sites you activate here also appear in the Web App, marked MainWP.
- Plan and invoices are on your plan page: Plans, upgrades and billing.