Troubleshooting and FAQ
Blunt answers to the things that actually go wrong.
Scanning#
"You've reached your plan's limit of 1 site."#
You're on the free plan, which allows one tracked site — and the portal has no way to remove a site once added. This message also appears when you try a loose scan of a different domain, which is easy to mistake for a bug. You need a paid plan to scan a second domain. Note the message says "Upgrade to Agency", but Individual Lite at $49/mo already allows 3 sites — you don't need an Agency plan.
A scan failed.#
It was refunded automatically — check Settings → Credit history for a "Refund — Website scan" line. Usual causes: the page needs a login (use the extension), it's a JavaScript-only shell with no server-rendered content, or robots rules block it.
My scan is stuck / nothing is happening.#
Scans run in the background and a large site queues them. Navigate away and come back — progress shows as x / y on the dashboard. A 51-page site finishes in a couple of minutes.
New pages aren't being scanned.#
Discovery isn't continuous. Go to Sitemaps → Re-discover pages (2 credits) after launching new sections.
Contrast findings changed between scans and I didn't change anything.#
This is expected and worth understanding. Contrast checks depend on what actually rendered — viewport width, lazy-loaded content, and background images all affect the result. Contrast counts are the least reproducible metric in automated accessibility testing. Trust the trend, not a single run.
Scores#
Why isn't my score 100?#
Almost no site scores 100 on a first scan. Zylyn's own site scores 92. See what is a good score.
My score dropped and I didn't change anything.#
Check pages scanned on the dashboard. If more pages have been scanned since you last looked, the average now includes pages that were previously unmeasured. A score over 44 of 51 pages isn't comparable to one over 51 of 51.
My score says POOR but there seem to be only a couple of real problems.#
Both can be true. The score counts best-practice rules alongside genuine WCAG failures, and weights by how many elements are affected — so one best-practice rule firing on every div drags the number down hard. Count the WCAG-tagged findings to see your actual conformance gap. Don't set a remediation budget from the headline percentage.
Does a high score mean I'm ADA or WCAG compliant?#
No. It means the machine-checkable part is clean. Automated testing reaches roughly 20–40% of WCAG success criteria. Conformance you can defend needs manual testing with assistive technology.
Credits#
Where did my credits go?#
Settings → Credit history itemises every transaction with a running balance.
I ran out mid-scan.#
Scans pause automatically. Top up or upgrade and re-run — you aren't charged for what didn't run.
Why did an export cost a credit?#
Exports are metered at 1 credit each (PDF, CSV, email). Export once and share the file.
Do unused credits roll over?#
Not stated in the portal. Ask Zylyn before relying on it.
AI fix suggestions#
A suggestion contains [PLACEHOLDER].#
That's the Needs your input status — the fix is structurally complete but needs wording only you can supply, like what a progress bar measures. Replace it; don't ship the placeholder.
It says "Dev required" — is the suggestion wrong?#
No, it means no safe automatic patch exists. Typically the change touches a shared design token or component, so applying it affects more than the page you scanned. A developer should decide.
Can I apply suggestions automatically?#
No, and you shouldn't want to. They're AI-generated and require review. A wrong aria-label is worse than none — it misleads screen reader users confidently.
Reports and VPAT#
The VPAT button doesn't work.#
Correct — both Sitewide VPAT and Generate & view VPAT are labelled "Soon" and aren't implemented. VPATs and ACRs are produced as a service today. Use Request remediation help or contact Zylyn.
What's the difference between Violations and Incomplete?#
Violations are confirmed problems. Incomplete means the scanner couldn't decide and a human needs to look — it does not mean "fine". See the four result buckets.
What does "Partial coverage" mean?#
Some content — usually third-party iframes — couldn't be scanned. The report covers what Zylyn could reach.
Account and access#
Can I remove a site? Not through the portal. Contact Zylyn.
Can I invite a colleague? Not on Free or Individual Lite. Team seats start at Individual Pro.
Who can see my reports? Everyone on your account — there's no per-member visibility control — and your managing agency if you have one. This includes reports from pages scanned behind a login.
I never got a confirmation email. There isn't one. Registration signs you straight in.
I forgot my password. Use Forgot password? in the login dialog.
Getting help#
Request remediation help on any report contacts Zylyn's accessibility team. For account or billing issues, use the contact route on zylyn.co.