Help
Plain answers, from the product as it works.
The questions the dashboard raises most, answered from what the software does. Each answer has its own link, so it can be sent on.
Why was my scan blocked, and how do I let the crawler in?
A scan is reported as blocked when the crawler could not read a single page of the site. The usual cause is a firewall or bot-protection rule that turns away unfamiliar visitors. The others are a robots.txt that disallows the crawler, and a robots.txt that cannot be read at all.
To let it in, allow requests whose user agent contains A11yDeskBot in the site’s firewall, bot protection or content delivery network. The full user agent is on the site’s screen in your dashboard, beside the failed scan.
Then check the site’s robots.txt. It has to answer normally, or with a 404 if the site has none: a robots.txt that returns an error, times out or redirects off the site stops the scan before any page is loaded. The crawler applies every Disallow rule under User-agent: * as well as those under its own name, and it ignores Allow lines, so a site that disallows everything for all crawlers cannot let it in with an Allow line. The Disallow has to be narrowed or removed.
Each site gets one scan a day, whether the schedule or Scan now starts it. Once the change is made, press Scan now, or wait for the next scheduled scan. If the site was already scanned today, Scan now is available again tomorrow.
Can I change the site on my trial?
The trial covers one client site, one scan a day and up to 500 pages a scan. If you added the wrong site, remove it from the site’s Settings tab and add the right one. That works while the site has no completed scan and nothing in its evidence log, and while no scan of it is queued or running, so a site whose first scan failed, from a mistyped domain say, can still be removed.
Once a scan of the site has completed, it can’t be removed, because its scan history and evidence log are kept as a record, and the trial stays on that site. You can pause its monitoring from the same tab instead, and nothing is deleted. A subscription covers every client site you look after.
Removing a site takes it off your dashboard and frees its place. We keep a note that it was added, with your confirmation that you were authorised to scan it.
What do critical, serious, moderate and minor mean?
They are axe-core’s impact levels. axe-core is the open-source set of accessibility rules every scan runs, and each issue carries the impact axe-core gives the check that failed. We don’t adjust it. It describes how much a problem is likely to get in someone’s way, not how hard it is to fix.
Critical: it can stop some people using the page, or part of it, at all. An image with no text alternative is usually critical.
Serious: a significant barrier. Some people get past it only with real difficulty, or with help. Text that does not contrast enough with its background is usually serious.
Moderate: it makes the page harder to use for some people, without stopping them.
Minor: more an annoyance than a barrier.
Every scan runs WCAG 2.2 level A and AA checks only, so a minor issue is still a failed WCAG check, not a matter of style. Counts on the dashboard and on reports count places, one rule failing on one element of one page, and lists put critical first. Severity is not a score, and no set of counts means a site is accessible.
Mark as fixed or confirmed by a re-scan: what’s the difference?
Mark as fixed is something your team says. On a rule’s screen, the “Fixed it?” panel records that you believe the issue is fixed. It resolves nothing: the issue still counts as open, on reports included, and nothing is written to the evidence log.
Confirmed by a re-scan is something a scan says. When a later scan no longer finds an issue, the issue is marked fixed and confirmed, and the evidence log gets a dated entry saying the fix was verified by re-scan, with the rule and the number of places. That happens whether or not anyone marked it first.
If the next scan still finds an issue you marked as fixed, it reopens. Until a scan decides, you can put it back to open yourself. An issue that a scan confirmed fixed and that later comes back is reported as regressed.
What stops when an account is read-only?
An account goes read-only when its trial ends without a subscription, or when a subscription ends.
What stops: every new scan, scheduled or started with Scan now, and adding sites. No new report or share link can be made, and scan settings, report summaries and link expiry can’t be changed. Issues can’t be marked as fixed, and notes can’t be added to the evidence log.
What keeps working: every finding, every report and every share link, the links your clients already have included. You can still revoke a link, download the account export from Settings, and delete the account. Nothing is deleted and nothing is charged.
How do I send a report to my client, and what will they see?
Open the client site and its Reports tab, pick the dates the report covers, then preview it. New report, at the top of the site’s screen, opens the preview with the dates filled in. A report reads the latest scan that finished inside its dates. Before you create it you can add a summary for your client, printed under the title, and choose when the link expires: never, or after 30 days, 90 days or a year. Then copy the share link and send it yourself. We never contact your clients.
Each site also has one live link, from Share live link on the site’s screen. It always shows the latest completed scan and the 90 days of evidence up to it, so a link you sent months ago shows this week’s results.
Your client needs no account. The page carries your agency’s name or logo, your colours, your contact details and your footer line, and no A11yDesk branding, though the link is on our domain, so our name is in the address bar. For a copy with no web address on it, open the report’s screen and use Save as PDF, then send the file yourself. It shows the scan date and the pages scanned, your summary, the issues by severity, what changed since the previous scan, the findings grouped by rule, and any evidence log entries for the period. The CSS selectors and HTML snippets your developers work from stay in your dashboard. Search engines are told not to index the page.
One line that no setting removes says that automated checks cover a subset of WCAG 2.2 criteria and that a full conformance assessment needs manual review.
You can change the summary and the expiry later, from the report’s screen. Revoke the link and anyone opening it gets a plain not-found page, with no sign a report was there. A revoked or expired link never works again: sharing again makes a new link. If a link reaches the wrong people, Replace this link makes a new one and stops the old one at once.
Where do I add my logo and agency details?
Open Settings, then Branding. Choose whether reports show your agency’s name, your logo or both, set your two colours, and add the contact details and footer line your clients see. The preview on the same page shows a sample report as you change it.
A report is drawn each time it is opened, from your branding as it is then, so a change reaches the reports and links you have already sent within a minute.
Question not answered here?
Reply to any email from us, or write to helloa11ydesk.com.