WCAG Levels Explained
Overview
The Web Content Accessibility Guidelines (WCAG) define three levels of conformance: A, AA, and AAA. Understanding these levels helps you set appropriate accessibility goals for your projects and interpret CodeFrog’s accessibility test results.
What is WCAG?
WCAG (Web Content Accessibility Guidelines) is an international standard published by the World Wide Web Consortium (W3C) that provides guidelines for making web content accessible to people with disabilities. The current version is WCAG 2.1, with WCAG 2.2 in development.
The Three Conformance Levels
Level A: Minimum
Level A represents the minimum level of accessibility. Meeting Level A means your website is accessible to some users with disabilities, but may still have significant barriers for others.
Key Level A Requirements:
- All images must have alternative text (alt attributes)
- All form inputs must have labels
- Content must be structured with proper headings
- Color cannot be the only means of conveying information
- All functionality must be keyboard accessible
- No content that flashes more than 3 times per second
- Page titles must be descriptive
When to Target Level A:
- As a starting point for accessibility improvements
- For internal tools or applications with limited user base
- When beginning your accessibility journey
Note: Level A alone is typically not sufficient for legal compliance in most jurisdictions.
Level AA: Standard (Recommended)
Level AA is the most commonly targeted conformance level and is often required by law in many countries, including:
- United States (Americans with Disabilities Act - ADA)
- European Union (EN 301 549)
- Canada (Accessible Canada Act)
- Australia (Disability Discrimination Act)
Key Level AA Requirements:
- Text contrast ratio of at least 4.5:1 for normal text
- Text contrast ratio of at least 3:1 for large text (18pt+ or 14pt+ bold)
- All functionality must be accessible via keyboard
- Focus indicators must be visible
- Headings and labels must be descriptive
- Error messages must be clear and helpful
- Content must be readable and understandable
- Navigation must be consistent
- Multiple ways to find content (navigation, search, sitemap)
When to Target Level AA:
- For public-facing websites and applications
- When legal compliance is required
- For most commercial and government websites
- As the standard for most projects
Legal Compliance: Level AA is typically the target for legal compliance. Many organizations are required to meet WCAG 2.1 Level AA standards.
Level AAA: Enhanced
Level AAA represents the highest level of accessibility conformance. While it’s the gold standard, achieving full AAA compliance can be challenging and may not be practical for all content types.
Key Level AAA Requirements:
- Text contrast ratio of at least 7:1 for normal text
- Text contrast ratio of at least 4.5:1 for large text
- Sign language interpretation for audio content
- Extended audio descriptions for video content
- No timing constraints (except for real-time events)
- Context-sensitive help available
- Abbreviations explained on first use
- Reading level appropriate for content
When to Target Level AAA:
- For high-priority public services
- When maximum accessibility is a core value
- For specific content types (educational materials, government services)
- As an aspirational goal for critical user flows
Important Limitations:
- Full AAA conformance requires manual testing with assistive technologies
- Some AAA requirements may not be practical for all content types
- Automated tools like CodeFrog can test for many AAA rules, but cannot catch everything
How CodeFrog Tests WCAG Levels
CodeFrog uses axe-core, the industry-leading automated accessibility testing engine, to test your websites for WCAG compliance. Our testing covers all three WCAG levels.
What Gets Tested
When you run an accessibility scan, CodeFrog tests for violations across:
- WCAG 2.0 Level A (
wcag2atag) - WCAG 2.0 Level AA (
wcag2aatag) - WCAG 2.1 Level AA (
wcag21aatag) - WCAG 2.1 Level AAA (
wcag21aaatag)
Understanding WCAG Ratings in Results
After running an accessibility scan, CodeFrog displays a WCAG Rating that shows which level your page passes based on automated testing:
- WCAG A: No Level A violations found
- WCAG AA: No Level A or AA violations found
- Automated testing never returns WCAG AAA—AAA always requires manual testing
Example:
- If your page has no Level A or AA violations but has some AAA violations, your rating would be “WCAG AA”
- If your page has no violations at all, your rating would still be “WCAG AA” (automated testing never returns AAA)
- If your page has Level A violations, it does not pass any level
Important Note: Automated testing can return A or AA ratings (never AAA), but full WCAG A, AA, or AAA conformance cannot be achieved with automated testing alone. Manual testing with assistive technologies (screen readers, keyboard navigation, etc.) is required for full conformance at any level. According to Deque (makers of axe-core), automated tests find less than 60% of accessibility issues on average. CodeFrog’s automated testing helps identify many issues, but should be combined with manual testing for complete WCAG compliance.
What CodeFrog Checks
CodeFrog’s accessibility testing checks for:
Color and Contrast:
- Text contrast ratios (AA: 4.5:1, AAA: 7:1)
- Color-only information without alternative indicators
Keyboard Navigation:
- All interactive elements are keyboard accessible
- Logical tab order
- Visible focus indicators
- No keyboard traps
ARIA and Semantics:
- Proper use of ARIA roles and attributes
- ARIA labels and descriptions
- Semantic HTML structure
- Proper heading hierarchy
Images and Media:
- Alt text for all images
- Captions for video content
- Audio descriptions where required
Forms:
- All inputs have associated labels
- Error messages are clear and helpful
- Form validation is accessible
Document Structure:
- Proper heading hierarchy (no skipping levels)
- Page landmarks (main, navigation, contentinfo)
- No duplicate IDs
Interpreting Your Results
WCAG Rating
The WCAG rating indicates the highest level your page passes based on automated testing. This is calculated by:
- Checking if there are any Level A violations
- If no Level A violations, checking for Level AA violations
- If no Level AA violations, the rating is “AA” (automated testing never returns AAA)
- The rating is the highest automated level (A or AA) with no violations
Limitation of Automated Testing: It’s important to understand that automated testing can return A or AA ratings (never AAA), but full WCAG A, AA, or AAA conformance cannot be achieved with automated testing alone. Manual testing with assistive technologies is required to achieve full compliance at any level. Automated tools like CodeFrog can identify many issues, but they cannot catch all accessibility problems. For example, automated tests may miss issues related to:
- Screen reader compatibility and user experience
- Keyboard navigation flow and logical order
- Content understandability and clarity
- Context-dependent accessibility requirements
For more information about the limitations of automated accessibility testing, see the Deque automated accessibility coverage report.
Health Score
In addition to the WCAG rating, CodeFrog provides an A-F health score based on the severity of findings:
- A: No critical, high, or medium issues; low issues ≤ 20
- B: Some medium issues or low issues > 20
- C: High issues present OR medium issues > 10
- D: High issues > 5
- F: Any critical findings
The health score and WCAG rating work together to give you a complete picture:
- WCAG Rating: Which accessibility standard level you meet
- Health Score: Overall quality based on issue severity
Finding Details
Each finding in your results includes:
- WCAG Level Tags: Shows which WCAG level(s) the violation affects
- Severity: Critical, High, Medium, Low, or Info
- Description: What the issue is and why it matters
- Remediation: How to fix the issue
- Affected Elements: Selectors or HTML snippets showing where the issue occurs
Best Practices
1. Target Level AA for Most Projects
For most websites and applications, Level AA is the recommended target because:
- It meets legal requirements in most jurisdictions
- It provides good accessibility for most users
- It’s achievable without being overly restrictive
- It’s the industry standard
2. Test Early and Often
Run accessibility scans during development, not just before launch:
- Catch issues when they’re easier to fix
- Build accessibility into your workflow
- Avoid costly last-minute fixes
3. Combine Automated and Manual Testing
While CodeFrog catches many issues automatically, manual testing is essential:
- Test with real screen readers (VoiceOver, NVDA, JAWS)
- Test keyboard-only navigation
- Test with users who have disabilities
- Verify that automated fixes actually work
4. Prioritize by Severity
When fixing issues:
- Critical and High severity issues first
- Level A violations before Level AA
- Level AA violations before Level AAA
- Focus on issues that affect the most users
5. Understand Automated Testing Limitations
Remember that:
- Full WCAG conformance at any level (A, AA, or AAA) requires manual testing
- Automated tools can only test a portion of accessibility criteria
- According to Deque research, automated tests find less than 60% of accessibility issues on average
- Manual testing with assistive technologies is essential for complete compliance
- Some requirements may not be practical for all content types
- Focus on critical user flows for comprehensive testing
Common Questions
Can I achieve WCAG A, AA, or AAA with CodeFrog alone?
No. While CodeFrog can test for many WCAG rules at all levels (A, AA, and AAA), full conformance at any level requires manual testing. Automated testing alone cannot fully verify WCAG compliance because:
- Automated tests find less than 60% of accessibility issues on average (Deque research)
- Many accessibility requirements need human judgment and real-world testing
- Screen reader compatibility must be tested with actual assistive technologies
- Keyboard navigation flow requires manual verification
- Content understandability and context-dependent issues need human evaluation
Full WCAG conformance requires:
- Manual testing with assistive technologies (screen readers, voice control, etc.)
- Human judgment for some criteria
- Testing with actual users who have disabilities
- Combining automated and manual testing approaches
CodeFrog helps you identify and fix many issues automatically, but manual testing is essential for full compliance at any WCAG level.
What if I have AAA violations but pass AA?
That’s normal! Your WCAG rating will show “WCAG AA” if you have no A or AA violations but some AAA violations. This means you meet the standard level (AA) but not the enhanced level (AAA).
Should I fix all AAA violations?
Not necessarily. Consider:
- Priority: Fix AAA violations in critical user flows
- Impact: Focus on violations that affect many users
- Feasibility: Some AAA requirements may not be practical for all content
- Resources: Balance accessibility goals with other priorities
How do I know which level to target?
- Level A: Starting point, internal tools
- Level AA: Most projects, legal compliance, public websites
- Level AAA: High-priority services, maximum accessibility goals
Related Topics
- Accessibility Testing - How to run accessibility tests in CodeFrog
- Mega Report - Comprehensive testing including accessibility
External Resources
- WCAG 2.1 Quick Reference - Official W3C reference
- Understanding WCAG 2.1 - Detailed explanations
- WebAIM Contrast Checker - Test color contrast ratios