Accessibility Scanner

What is the Accessibility Scanner?

The Accessibility Scanner is a powerful tool that automatically checks your website for compliance with WCAG 2.2 standards. It helps you identify, understand, and fix accessibility issues, making your site usable for everyone and reducing legal risk.

Key Features

1. Automated Scanning

1. On-Demand Scans: Instantly scan any page, post, or custom URL from the admin dashboard.
2. Scheduled Scans: Set up daily, weekly, or custom-interval scans to monitor your site over time.
3. Supports Page Builders: Works with Elementor, WPBakery, Divi, and more.
4. Severity Classification: Issues are categorized as Critical, Serious, Moderate, or Minor for easy prioritization.

2. 11 Specialized Checkers


The scanner uses 11 dedicated checkers to cover all major WCAG 2.2 requirements:

5. ImageChecker: Checks alt text, image maps, SVG metadata.
6. HeadingChecker: Detects missing, multiple, skipped, or empty headings.
7. FormChecker: Validates labels, required fields, fieldsets, and buttons.
8. LinkChecker: Finds empty, ambiguous, or broken links.
9. AriaChecker: Flags invalid ARIA roles and attributes.
10. KeyboardChecker: Ensures keyboard navigation and tabindex order.
11. SemanticChecker: Checks for language attributes and title elements.
12. MultimediaChecker: Verifies captions and transcripts for audio/video.
13. TableChecker: Checks table headers, captions, and structure.
14. ColorContrastChecker: (Planned) Will check color contrast for text and UI elements.
15. BaseChecker: Abstract base for all checkers, ensuring consistency.

3. Detailed Reports


16. Issue Breakdown: Each issue includes a description, affected element, and recommended fix.
17. WCAG Mapping: Every issue is linked to the relevant WCAG criterion for reference.
18. Remediation Guidance: Step-by-step instructions to resolve each problem.
19. CSV Export: Download scan results for offline review or sharing with your team.

4. Notifications & Integrations


20. Email Alerts: Automatically sends scan results to specified recipients.
21. Dashboard Updates: Summaries and trends are displayed in the Compliance Dashboard.
22. REST API: Trigger scans and retrieve results programmatically.
23. WP-CLI: Run scans and export results from the command line.

How to Use


24. Run a Scan: Go to ComplyFlow → Accessibility, select a page or enter a URL, and click “Scan Now.”
25. Schedule Scans: In Settings → Accessibility, set your preferred scan frequency and notification emails.
26. Review Results: View issues in the admin UI, filter by severity, and export as needed.
27. Fix Issues: Follow the remediation guidance for each issue. Re-scan to verify fixes.

Settings & Customization


28. WCAG Level: Choose A, AA, or AAA compliance.
29. Scan Frequency: Daily, weekly, fortnightly, or monthly.
30. Notification Recipients: Add emails to receive scan reports.
31. Auto-Fix Options: (Planned) Enable automatic remediation for certain issues.

Troubleshooting & Tips


32. If scans fail, check your site’s public accessibility and ensure no firewall is blocking requests.
33. For missing issues, verify that all modules and checkers are enabled in settings.
34. Use the CSV export to share results with developers or accessibility consultants.
35. Schedule regular scans to maintain compliance as your site evolves.

Advanced Usage


36. REST API: Use /complyflow/v1/scan endpoints to automate scans from external tools.
37. WP-CLI: Run wp complyflow scan run --url= for headless or batch scanning.
38. Integration: Results can be linked to ticketing systems or QA workflows.

Related Documentation


39. See Compliance Dashboard for how scan results are visualized.
40. See Admin Settings for configuring scan schedules and notifications.