A11yRisk Help

Automated WCAG accessibility scanning for every website.

Important notice: A11yRisk is an automated accessibility testing tool. Scan results identify potential issues to help guide remediation. They do not constitute a compliance certification, legal opinion, or guarantee of conformance with any regulation or standard. For a comprehensive accessibility evaluation, combine automated scans with manual testing and review by an accessibility specialist.

1. What A11yRisk does

A11yRisk crawls your website and tests every page against the WCAG (Web Content Accessibility Guidelines) standard you choose. After a scan completes, you receive a prioritised list of violations — each tagged with the exact WCAG criterion, the severity, the affected HTML element, and a link to remediation guidance. You can download the results as a PDF (for audit reporting and client documentation) or as JSON (for developer tooling and further analysis).

Who it is for:

RolePrimary use
Web developer / engineerFind and fix violations before a deployment. Download JSON output to analyse violations in developer tooling.
Digital agencyAudit client sites. Deliver PDF accessibility audit reports. Manage multiple workspaces under one account.
Compliance officer / project managerTrack accessibility test findings over time. Share automated scan reports with project stakeholders.
Accessibility specialistRun a fast automated baseline audit before or alongside manual testing.

What it checks:

A11yRisk uses axe-core — the industry-standard open-source accessibility testing engine — with full-page browser rendering. Every scan exercises JavaScript, CSS, and dynamic content, not just the static HTML source.


2. Your first scan — free

New accounts receive one free credit. A credit covers one page. To activate it:

  1. Sign in and go to Billing in the left-hand navigation.
  2. Click Add payment method in the activation banner.
  3. Enter your card details. Your card is not charged. It is stored to prevent misuse of the free tier.
  4. Once saved, 1 credit is added to your balance automatically.
  5. Go to New Scan, enter your URL, set the page limit to 1, and click Create Scan.
Note: If your workspace has already activated the free credit, the activation banner will not appear. Check your credit balance in the top-right corner of the Billing page.

3. Running a scan

Select New Scan from the sidebar or the New Scan button on the Dashboard.

Website URL

Enter the full URL of the page you want to start from, including the scheme:

https://example.com

The crawler follows internal links from this starting page outward, up to the page limit you set. It does not follow external links or links to subdomains not included in the starting URL.

Page limit

The Page limit field caps how many pages the crawler will visit. One credit is used per page scanned.

Page limitCredits used (maximum)
11
10up to 10
20 (default)up to 20
500 (maximum)up to 500

The actual number of credits deducted equals the number of pages successfully scanned — if the site has fewer pages than the limit, only the actual page count is charged. Your current credit balance and the maximum pages that can be reserved for the scan are shown below the form before you submit.

WCAG standard

Choose the conformance level to test against. The default is WCAG 2.1 Level AA, the level referenced by EU EAA and US Section 508 regulations.

StandardLevelUse case
WCAG 2.1AMinimum — basic accessibility requirements
WCAG 2.1AAReferenced by EU EAA and US Section 508 — recommended
WCAG 2.1AAAEnhanced — government / healthcare
WCAG 2.2AMinimum — basic accessibility requirements
WCAG 2.2AACurrent W3C standard
WCAG 2.2AAAStrictest

WCAG 2.1 AA is the most widely enforced standard. Select WCAG 2.2 AA if you want to test against the latest W3C specification, which adds several new success criteria to 2.1 AA.

Submitting

Click Create Scan. You will be redirected to the scan detail page, where progress updates automatically — you do not need to stay on the page while the scan runs.


4. Scan progress and status

Every scan passes through the following stages in order:

StatusWhat is happening
QueuedThe scan is waiting for an available worker.
CrawlingThe crawler is following links from your starting URL and building a list of pages to test.
ScanningEach page is being loaded in a real browser and tested with axe-core.
AggregatingResults from all pages are being combined and deduplicated.
Generating reportThe PDF report is being rendered and uploaded.
DoneThe scan is complete. Results and downloads are available.
FailedThe scan could not complete. See Frequently asked questions below.
CanceledYou or another workspace admin canceled the scan before it finished.

While scans are running, the sidebar shows a banner with the count of active scans. Clicking the banner takes you to the Scans list.

Canceling a scan

While a scan is in any non-terminal status (Queued, Crawling, Scanning, Aggregating, or Generating report), a Cancel scan button is available on the scan detail page and on the Scans list. Credits for pages already scanned at the time of cancellation are consumed; pages not yet scanned are not charged.


5. Reading your results

When a scan reaches Done status, the violations table appears on the scan detail page.

Violation columns

ColumnDescription
Page URLThe specific page on which the violation was found.
WCAG CriteriaThe WCAG success criterion that is violated (e.g., 1.4.3 Contrast). Clicking the criterion opens the W3C documentation.
ImpactSeverity of the violation — see impact levels below.
SourceThe detection method — see sources below.
DescriptionA plain-English explanation of the violation, linked to axe-core's remediation guidance.
ElementThe HTML snippet of the affected element on the page.

Impact levels

Impact is assigned by axe-core based on how severely the violation affects users with disabilities.

ImpactMeaning
CriticalCompletely prevents access for affected users. Fix immediately.
SeriousCauses significant difficulty. High priority for remediation. Fix before launch.
ModerateCauses difficulty for some users. Fix in next iteration.
MinorMinor inconvenience. Address as time allows.

Critical and Serious violations represent the highest accessibility barriers and should be resolved as a priority. Moderate violations should be addressed; Minor violations are typically noted but not blocking.

Violation sources

SourceMeaning
AxeDetected by the axe-core rule engine during page rendering.
CustomDetected by an A11yRisk custom rule (e.g., PDF link detection, lang attribute checks).
StateDetected by simulating interactive states such as focus, hover, or keyboard navigation.

WCAG conformance tags

Each violation carries one or more conformance tags indicating which WCAG version and level the rule belongs to. These tags appear in the JSON export and in detailed violation data.

TagVersionLevel
wcag2aWCAG 2.x (any)A
wcag2aaWCAG 2.x (any)AA
wcag2aaaWCAG 2.x (any)AAA
wcag21aaWCAG 2.1 specificallyAA
wcag22aWCAG 2.2 specificallyA
wcag22aaWCAG 2.2 specificallyAA
wcag22aaaWCAG 2.2 specificallyAAA

Tags without a minor version (e.g. wcag2aa) apply to all WCAG 2.x versions. Tags with a minor version (e.g. wcag22aa) are specific to that release. A violation may carry both — for example, wcag2aa and wcag21aa on the same rule indicates it is required by WCAG 2.x AA and was formalised in the 2.1 revision.

Filtering violations

Use the filter controls above the table to narrow results:

  • Filter by impact — show only violations at or above a selected severity.
  • Filter by source — show only violations from a specific detection method.
  • Search WCAG criteria — type a criterion number or keyword (e.g., 1.4.3 or contrast) to filter by WCAG tag.

No violations found

If the table shows "No violations found", the scanned pages passed all tested rules at the selected WCAG level. This is a strong result, but note that automated testing cannot cover all WCAG success criteria — manual testing and user testing with assistive technologies are still recommended for a thorough accessibility review.


6. Downloading reports

Once a scan is complete, two download buttons appear on the scan detail page.

PDF report — accessibility audit record

Download PDF generates a formatted accessibility audit report suitable for:

  • Sharing with a client, auditor, or project stakeholder as a record of automated testing.
  • Providing to a project manager or development team as a baseline for remediation.
  • Sharing with a project manager or stakeholder who does not use the platform directly.

The PDF includes the scan metadata (URL, date, WCAG standard, page count), a summary of violations by impact level, and the full violation list with descriptions and HTML elements.

JSON export — developer tooling

Download JSON provides the raw violation data in a machine-readable format suitable for:

  • Importing into issue trackers or project management tools.
  • Writing scripts to count, filter, or diff violations across releases.
  • Processing in developer tooling or accessibility dashboards.

The JSON structure follows axe-core's output schema, extended with A11yRisk metadata (page URL, scan ID, WCAG standard, timestamps).

Download link validity: Download links are generated fresh each time you click the button and are valid for 1 hour. The report files themselves are retained for 30 days after the scan completes — after that they are permanently deleted. If a link has expired but the report is still within the 30-day window, click the button again to get a fresh link.

7. Credits and billing

How credits work

One credit is consumed for each page successfully scanned. When you submit a scan, credits equal to the page limit are reserved from your balance immediately. At scan completion, any credits reserved for pages not actually scanned are automatically refunded — the net charge always equals the number of pages successfully processed. If a scan is canceled mid-way, only pages already scanned are charged. Credits never expire. A pack you purchase today is available indefinitely.

Credit packs

PackCreditsBest for
Starter5Testing a small site or running an initial audit
Team20Regular scanning of a medium site or a handful of client sites
Agency60Ongoing scanning across multiple client sites or large deployments

To purchase a pack, go to Billing in the sidebar. Only workspace Admins can purchase credits. If you are a Member, the Billing page will show your current balance and prompt you to contact your workspace admin.

Checking your balance

Your credit balance is shown:

  • In the Credits Remaining stat card on the Dashboard.
  • In the top-right corner of the Billing page.
  • Below the scan form on the New Scan page, as a reminder before you submit.

Checkout and activation

Clicking Buy credits on a pack card opens a Stripe-hosted checkout page. After completing payment, you are redirected back to the Billing page. Credits are added to your balance automatically within a few seconds. If your balance does not update immediately, the page will poll for the update — wait up to 20 seconds before refreshing.

Free credit

New accounts can activate one free credit by adding a payment method on the Billing page. The card is not charged. See Your first scan — free for step-by-step instructions.


8. Team management

Roles

RolePermissions
AdminRun scans, view results, manage team members, purchase credits, change settings.
MemberRun scans, view results. Cannot purchase credits or manage team membership.

Every workspace must have at least one Admin. The account that creates the workspace is assigned Admin role automatically.

Inviting a team member

Only Admins can invite new members.

  1. Go to Team in the sidebar.
  2. Click Invite.
  3. Enter the team member's email address.
  4. Select their role: Member or Admin.
  5. Click Invite. An invitation email is sent immediately.

The invited user receives an email with a link to create or sign in to their A11yRisk account. Once they accept, they appear in the team members list.

Removing a team member

  1. Go to Team.
  2. Find the member in the table.
  3. Click the remove action next to their row.
  4. Confirm the removal.

Removed members lose access to the workspace immediately. Their past scans remain in the workspace history.

Shared credit balance

Credits belong to the workspace, not to individual users. All team members share the same credit balance. Any member who runs a scan consumes credits from the shared balance. Only Admins can purchase credits to replenish it.


9. Settings

Organisation name

The workspace name appears in the sidebar and in any PDF reports generated by the workspace. To update it:

  1. Go to Settings.
  2. Edit the Organisation Name field.
  3. Click Save Changes.

If your workspace is using a default system-generated name, a banner will remind you to update it.

Language

A11yRisk is available in English, German, French, Dutch, and Polish. To change the interface language:

  1. Go to Settings.
  2. Under Language, select your preferred language from the dropdown.

The interface updates immediately. Language preference is stored per-user, not per-workspace — each team member can set their own language independently.


10. Frequently asked questions

How long does a scan take?

Scan time depends on the number of pages and the complexity of each page. A 1-page scan typically completes in under a minute. A 20-page scan typically takes 3–8 minutes. A 500-page scan may take 30–60 minutes. The scan detail page updates in real time — you do not need to keep the tab open.

Can I scan a staging or localhost URL?

Yes, if the URL is publicly reachable from the internet. Private network addresses (localhost, 10.x.x.x, 192.168.x.x, 172.16–31.x.x) are blocked for security reasons.

Can I scan a URL that requires a login?

Not in the current version. The scanner uses an unauthenticated browser session. If your pages require authentication, consider scanning a staging environment with public access, or contact support to discuss authenticated scanning options.

The scan shows 0 violations. Is that correct?

It may be. However, automated testing cannot cover every WCAG success criterion. Criteria involving subjective judgement (e.g., 1.4.5 Images of Text, 2.4.6 Headings and Labels, 3.3.2 Labels or Instructions) require human review. A zero-violation automated result is a strong signal but not a complete accessibility guarantee. Pair automated scans with manual testing and testing with screen readers for a comprehensive audit.

A violation says the element is "#document". What does that mean?

Some axe-core rules test the page document as a whole rather than a specific element — for example, checking that the <html> element has a lang attribute. The #document element reference indicates the violation applies to the page level.

Can I re-scan the same URL?

Yes. Each scan is independent and consumes credits according to the pages it covers. Re-scanning is recommended after deploying fixes to verify remediation.

What is the difference between WCAG 2.1 AA and WCAG 2.2 AA?

WCAG 2.2 introduces new success criteria not present in 2.1. The additions relevant to AA conformance include:

  • 2.4.11 Focus Not Obscured (Minimum)
  • 2.4.12 Focus Not Obscured (Enhanced)
  • 2.4.13 Focus Appearance
  • 2.5.7 Dragging Movements
  • 2.5.8 Target Size (Minimum)
  • 3.2.6 Consistent Help
  • 3.3.7 Redundant Entry
  • 3.3.8 Accessible Authentication (Minimum)
  • 3.3.9 Accessible Authentication (Enhanced)

EU EAA and US Section 508 currently reference WCAG 2.1 AA. WCAG 2.2 AA is the current W3C recommendation and is expected to be referenced by future regulations.

My scan failed. What should I do?

A scan can fail if the starting URL is unreachable, returns an error status, or the crawler encounters a persistent network issue. Check that:

  1. The URL is publicly accessible from the internet.
  2. The URL returns an HTTP 200 response (not a redirect loop, 403, or 5xx error).
  3. The site does not block automated browsers (some bot-protection configurations block our scanning engine).

If the issue persists, contact support with the scan ID from the scan detail page URL.

Who can see my scan results?

Scan results are visible to all members of your workspace. They are not visible to other workspaces or to A11yRisk staff without your explicit permission. For full details, see the Privacy Policy.


11. Glossary

axe-core
The open-source accessibility testing engine developed by Deque Systems. A11yRisk uses axe-core to evaluate pages against WCAG rules. github.com/dequelabs/axe-core
Conformance level
WCAG defines three levels of conformance: A (minimum), AA (standard), and AAA (enhanced). EU EAA and US Section 508 both reference Level AA.
Credit
The unit of consumption in A11yRisk. One credit = one page scanned. Credits are reserved at submission and refunded for any unscanned pages at completion. Credits never expire.
Crawler
The component that automatically follows internal links from your starting URL to discover pages to scan. Controlled by the page limit setting.
EU EAA
European Accessibility Act. EU directive that requires websites and mobile apps serving EU customers to meet WCAG 2.1 AA. Enforcement began June 2025.
Impact
axe-core's classification of how severely a violation affects users: Critical, Serious, Moderate, or Minor.
Section 508
US federal law requiring federal agencies and their contractors to make electronic information accessible. References WCAG 2.1 AA.
Success criterion
An individual testable requirement within WCAG, identified by a number (e.g., 1.4.3) and a name (e.g., Contrast Minimum). A11yRisk maps every violation to the success criterion it fails.
Violation
An instance of a page element failing a WCAG success criterion. One scan may find many violations across many pages.
WCAG
Web Content Accessibility Guidelines. Published by the W3C. The internationally recognised standard for web accessibility.
WCAG conformance tag
A short code used by axe-core to label which WCAG version and level a rule belongs to (e.g. wcag2aa = WCAG 2.x Level AA, wcag22aa = WCAG 2.2 Level AA). Tags without a minor version apply to all WCAG 2.x releases. These tags appear in the JSON export and in detailed violation data. See "WCAG conformance tags" in Section 5 for the full reference table.
Workspace
Your organisation's account in A11yRisk. All team members, scans, credits, and settings belong to the workspace. Members of the same workspace share a credit balance and can see each other's scans.
© 2026 A11yRisk. All rights reserved.