Regression protection for accessibility fixes
Validiscan’s regression protection scans your shop again on a fixed schedule after a project, weekly or monthly, and compares each run with the baseline. When a failure that was fixed comes back, the finding is reopened and a digest email goes out.
Last updated:
On this page: 9 answers
What happens in a run?
A regression protection run is a new scan of your shop, compared with what Validiscan already knows about it. The failures it finds are matched with your shop’s existing findings, the pages it reached are compared with the comparison scan, and the run appears in the timeline in the customer portal.
- The shop is scanned again.
- The findings are matched.
- The pages are compared.
- The result is recorded.
Details: the four steps, and which pages a run scans
Each run is a new scan of your shop, compared with what Validiscan already knows about it. A run takes four steps:
- The shop is scanned again. ValidiscanBot scans the shop with the scan settings stored for it. With the default settings, that means the same kinds of pages as a full scan, at desktop and phone size, including the cart and the first checkout step, without completing a purchase or entering payment data.
- The findings are matched. Every failure the run finds is matched with your shop’s existing findings, so Validiscan knows which ones were fixed before and which ones are new.
- The pages are compared. The pages the run reached are compared with those of the comparison scan.
- The result is recorded. The run appears in the timeline in the customer portal. When it found something, or could not finish, a digest email goes out.
How often is the shop scanned again?
Regression protection runs weekly or monthly, on a fixed schedule: a weekly run on a set weekday and time, a monthly run on a set day of the month and time, both in your organization’s time zone. The service Validiscan offers covers a weekly re-scan.
Six weekly re-scans
- Week 1 no regression
- Week 2 no regression
- Week 3 no regression
- Week 4 one regression, email sent
- Week 5 no regression
- Week 6 scheduled
Week 4 found a regression: one email, one entry on the timeline. Week 6 is scheduled.
Example dataDetails: the schedule in the portal, and when a run is skipped
Regression protection runs weekly or monthly, on a fixed schedule. A weekly run takes place on a set weekday and time, a monthly run on a set day of the month and time, both in your organization’s time zone. The service Validiscan offers covers a weekly re-scan.
The customer portal shows the schedule and the date of the next check. A run is skipped while your shop is paused in Validiscan, or while Validiscan has no recorded permission to scan it.
What is each run compared with?
Each regression protection run is compared with the history of your shop’s findings and with a comparison scan, the baseline: the latest completed verification scan, or the latest completed full scan if the shop has no verification scan yet. Validiscan picks the comparison scan again for every run.
- The comparison scan
- the latest completed verification scan, or the latest completed full scan if the shop has no verification scan yet
- Picked
- again for every run
- A finding is recognized by
- a fingerprint made from the rule, the element’s selector and the shape of its HTML
Details: the comparison scan, and how findings are recognized
Each run is compared with the history of your shop’s findings and with a comparison scan, the baseline. The comparison scan is the latest completed verification scan, or the latest completed full scan if the shop has no verification scan yet. Validiscan picks it again for every run, so after a new verification scan, the next run is compared with that one.
Findings are recognized from one scan to the next by a fingerprint made from the rule, the element’s selector and the shape of its HTML. That is how a run knows that a failure it finds is one that was fixed before.
What counts as a regression?
A regression is a failure that was fixed and is found again: a finding with the status fixed, verified or resolved externally that a regression protection run finds again. The run reopens it, so its status is open again, and reports it as a regression.
- Found again with the status
- FixedVerifiedResolved externally
- Reopened as
- Open and reported as a regression
Details: the statuses a regression reopens, and why fixed problems come back
A regression is a failure that was fixed and is found again. Precisely: a finding with the status Fixed, Verified or Resolved externally that a run finds again. The run reopens it, so its status is Open again, and reports it as a regression.
Fixed problems can come back, for example after a theme or app update.
What else does a run report?
Besides regressions, a regression protection run reports what is new, what is gone, and whether the pages it reached have changed. A run that finishes and finds no regression and none of these changes is all clear.
- New finding
- A failure your shop has never had in any earlier scan. Serious and critical new findings are highlighted. Best-practice findings, and findings marked as a false positive or as won’t fix, do not count.
- Resolved finding
- A finding that was still open or being fixed and that the run does not find, while every page where it was last seen was scanned again without error. It counts as fixed when Validiscan delivered a fix for it, and otherwise as resolved externally.
- Coverage change
- The pages the run loaded without error differ from the comparison scan’s: a kind of page, such as product pages or the cart, appears or disappears, or the number of pages differs from the comparison scan’s by more than 20%. Different page addresses alone do not count, because the product and category pages in a scan are a sample that changes from scan to scan.
- Could not finish
- The scan failed or was stopped before it finished, so nothing was compared. Problems it had already found coming back before it stopped are still reported.
When do you get an email?
A regression protection run sends one digest email when it finds a regression, a new or resolved finding or a coverage change, or could not finish. A run that finds none of these sends no email, unless Validiscan has switched on a digest after every run because you asked for one.
| When | Digest email |
|---|---|
| A run finds a regression | One digest |
| A run finds a new finding, a resolved finding or a coverage change | One digest |
| A run could not finish | One digest, so that you know the shop was not checked that time |
| A run finds none of these | No email, unless Validiscan has switched on a digest after every run because you asked for one (off by default) |
| Regression protection is paused | None: no runs take place and no digest is sent |
Details: who gets the digest, its subject and what it lists
Validiscan sends at most one digest email per run. A run sends one when it finds a regression, a new finding, a resolved finding or a coverage change, or when it could not finish. A run that finds none of these sends no email, unless Validiscan has switched on a digest after every run because you asked for one. That setting is off by default.
- A run that could not finish sends a digest too, so that you know the shop was not checked that time.
- The digest goes to the email addresses set up for your shop’s regression protection, in your organization’s language.
- Its subject names your shop and says how many fixed problems came back, or that none did (with the number of new problems, if there are any), or that the check could not finish.
- It lists what came back first, then the new findings with the serious and critical ones first, then the resolved findings and any change in the pages checked. Its links open the findings and the timeline in the customer portal.
- While regression protection is paused, no runs take place and no digest is sent.
What does the timeline in the portal show?
The timeline is on the customer portal’s regression protection page for each shop. The page shows the schedule, the next check and the latest checks, newest first, each with its date and its result: All clear, Something came back, Changes found, Could not finish, Stopped or Under way.
Details: what each result means, and what is listed under each check
The customer portal has a regression protection page for each shop. It shows the schedule, the next check, and the latest checks, newest first, each with its date and its result:
| Result | What it means |
|---|---|
| All clear | The check found no regression, no new or resolved finding and no change in the pages checked. |
| Something came back | At least one problem that was fixed was found again, and the check reopened it. |
| Changes found | Nothing came back, but the check found new or resolved findings, or a change in the pages checked. |
| Could not finish | The check failed, so nothing was compared. If it found problems coming back before it stopped, they are listed. |
| Stopped | The check was stopped before it finished. The next one runs as planned. |
| Under way | The check has not finished yet. Its results appear when it has. |
Under each check, the timeline lists the problems that came back, the new ones and how many of them are serious or critical, the ones no longer found, and the kinds of pages that appeared or disappeared. Each problem links to its finding and says where it stands now, for example that it was fixed again. For a check that could not finish, the timeline says so in a plain sentence and shows no technical error text.
What happens when something comes back?
A regression reopens the finding, so it is listed again among your shop’s open findings in the customer portal. It can then be fixed in the same steps as the project, followed by a verification scan. Fixing what a re-scan finds is not part of regression protection.
Details: how a fix follows, and what regression protection covers
A regression reopens the finding, so it is listed again among your shop’s open findings in the customer portal. It can then be fixed in the same steps as the project: a fix delivered as a pull request, an unpublished copy of your Shopify theme or a patch bundle, followed by a verification scan. Fixing what a re-scan finds is not part of regression protection.
It covers a weekly re-scan against the verified baseline, an email when something regresses, and the timeline in the portal. It is billed monthly and can be cancelled to the end of any month.
What does regression protection not do?
Regression protection does not repeat the manual checks of the project, and it changes nothing in your shop’s code. A re-scan is automated: it finds what automated checks can find on the pages it reaches.
-
Manual checks
Not repeated. A re-scan is automated: it finds what automated checks can find on the pages it reaches.
-
Your shop’s code
Not changed.
-
Fixing what a re-scan finds
Not part of regression protection.
Details: what an automated re-scan can find
Regression protection does not repeat the manual checks of the project, and it changes nothing in your shop’s code. A re-scan is automated: it finds what automated checks can find on the pages it reaches.
What automated accessibility testing can and cannot proveStart with a free check of your shop.
Send your shop’s address. Validiscan scans it and replies with every failure the scan can prove, with the page and the code.
Request a free checkOr write to info@validiscan.com.
What the free check covers, and what it leaves out- You send
- your shop’s address
- Pages scanned
- up to 15
- You get
- every failure the scan can prove, with the page and the code
- On your shop
- public pages only; no login, nothing bought, no forms sent
- What it is not
- a full audit