MainWP add-on: every screen and setting

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 Run tab of WebChange Detector for MainWP with the update summary and the button to run visual checks and updates
  • 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

The Account tab of WebChange Detector for MainWP: create an account, or enter an existing API token and save it
  • 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

The Account tab of WebChange Detector for MainWP once connected: plan, checks available, active sites, the API token, Auto-enable new sites and Reset connection
  • 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 site list of the add-on: switch visual checks on per site, then configure URLs and settings
  • 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.

Visual check settings of one MainWP site: region, alert e-mails, delay and CSS
  • 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.

The preflight of a WCD Update: which sites get updated, which pages are checked and whether the checks are covered
  • 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.

The Checks tab with WCD Update runs, their AI summaries and the status of each comparison
  • 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:

The WebChange Detector bar on the MainWP Updates page with the buttons Update Selected with Checks and Update All with Checks
  • 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.

The WebChange Detector tab of a child site in MainWP with the buttons Update with Checks and Configure URLs
  • 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.

WebChange Detector Newsletter

News, feature Updates, and insights.
No spam. Unsubscribe anytime.