A high-performance, enterprise-grade Email HTML Validation Framework built with Java, Playwright, Axe-Core, and ExtentReports.
The framework validates marketing emails, CRM templates, transactional emails, and campaign HTML files against accessibility, content quality, email development best practices, and compliance standards.
Email Audit Engine performs automated validation of HTML email templates and generates detailed audit reports containing:
- Accessibility violations
- Content quality issues
- Link validation results
- Duplicate ID detection
- ALT text validation
- Screenshot evidence
- Detailed Extent HTML reports
- Historical execution tracking
The framework is designed for:
- Marketing Operations Teams
- QA Teams
- Email Developers
- Accessibility Auditors
- CRM Campaign Teams
Powered by Axe-Core.
Checks:
- WCAG accessibility violations
- ARIA issues
- Landmark issues
- Contrast violations (where detectable)
- Form accessibility
- Semantic structure validation
Validates:
- Missing title tags
- Missing meta descriptions
- Empty headings
- Empty buttons
- Empty links
- Empty content blocks
- Placeholder text detection
- Broken content structures
Validates:
- Missing href attributes
- Empty href values
- Invalid URLs
- Broken HTTP/HTTPS links
- Mailto links
- Anchor links
- Redirect handling
Detects:
- Missing ALT attributes
- Empty ALT values
- Generic ALT text
Examples:
alt="image"
alt="banner"
alt="photo"
alt="picture"
alt="img"Supports accessibility best practices.
Detects duplicate HTML IDs.
Example:
<div id="hero"></div>
<div id="hero"></div>Provides:
- Duplicate ID value
- Occurrence count
- Location details
Captures full-page screenshots using Playwright.
Features:
- Full-page screenshots
- Timestamped file naming
- Automatic evidence collection
- Audit traceability
Generates enterprise reporting using ExtentReports.
Includes:
- File-level results
- Rule-level breakdowns
- Pass/Fail summaries
- Failure leaderboard
- Screenshot evidence
- Execution metrics
Prevents re-processing of identical files.
Uses:
- SHA-256 hashing
- Historical state tracking
- Duplicate identification
Tracks:
- Previously processed files
- File hashes
- Processing status
- Execution timestamps
Benefits:
- Faster incremental executions
- Duplicate prevention
- Audit traceability
Email Audit Engine
│
├── Audit Orchestrator
│
├── Rule Executor
│
├── Accessibility Rules
│ └── Axe-Core
│
├── Content Rules
│
├── Link Rules
│
├── Image Rules
│ ├── ALT Text Validation
│ └── Duplicate ID Validation
│
├── Screenshot Service
│
├── Report Manager
│
├── Archive Manager
│
└── State Registry
| Component | Technology |
|---|---|
| Language | Java 17 |
| Browser Engine | Playwright |
| Accessibility Engine | Axe-Core |
| Reporting | ExtentReports |
| Logging | SLF4J |
| Build Tool | Maven |
| State Tracking | JSON Registry |
| Hashing | SHA-256 |
| Rule ID | Category | Description |
|---|---|---|
| ACCESSIBILITY_AXE | Accessibility | Axe accessibility scan |
| CONTENT_VALIDATION | Content | Content quality checks |
| LINK_VALIDATION | Links | Link validation |
| ALT_TEXT_VALIDATION | Accessibility | Image ALT text validation |
| DUPLICATE_ID_VALIDATION | Accessibility | Duplicate HTML ID validation |
mvn clean package
java -jar email-audit-engine.jartarget
│
├── audit-reports
│ └── audit-report.html
│
├── audit-screenshots
│ ├── email1_20250611T120101123Z.png
│ ├── email2_20250611T120103456Z.png
│
├── archive
│ ├── passed
│ ├── failed
│
└── state
└── audit-state.json
Each HTML file generates:
sample-email.html
PASS
FAIL
ERROR
SKIPPED
Rule Breakdown:
ACCESSIBILITY_AXE
CONTENT_VALIDATION
LINK_VALIDATION
ALT_TEXT_VALIDATION
DUPLICATE_ID_VALIDATION
Screenshot Evidence
Execution Metrics
Designed for large-scale email auditing.
Capabilities:
- Parallel file processing
- Thread-safe execution
- SHA-256 deduplication
- Incremental processing
- Efficient screenshot capture
- Lightweight reporting
Validate:
- Campaign emails
- Promotional emails
- Newsletters
- Customer journeys
Validate:
- WCAG compliance
- Screen-reader compatibility
- Accessibility regressions
Integrate into:
- GitHub Actions
- Jenkins
- Azure DevOps
- GitLab CI/CD
Prevent deployment of non-compliant emails.
- Accessibility Validation (Axe)
- Content Validation
- Link Validation
- Screenshot Evidence
- Extent Reporting
- Historical State Registry
- Duplicate File Detection
- ALT Text Validation
- Duplicate ID Validation
- Heading Hierarchy Validation
- Color Contrast Validation
- Missing Language Attribute Detection
- Email Subject Length Validation
- Button Accessibility Validation
- Table Accessibility Validation
- Unsubscribe Link Validation
- Email Client Compatibility Checks
- Spam Score Analysis
- Broken Image Detection
- Tracking Pixel Validation
- Responsive Design Validation
<img src="banner.jpg">Result:
FAIL
Image missing ALT attribute
<div id="hero"></div>
<div id="hero"></div>Result:
FAIL
Duplicate ID detected: hero
Occurrences: 2
src
│
├── config
├── orchestration
├── reporting
├── evidence
├── rules
│ ├── accessibility
│ ├── content
│ ├── links
│ └── images
│
├── state
├── archive
└── utils
Planned support includes:
- Accessibility Compliance (WCAG 2.1 AA)
- Email Development Standards
- Content Governance
- Marketing Compliance
- Deliverability Validation
- Responsive Rendering Checks
- Brand Consistency Validation
- Spam Detection Rules
- Email Client Compatibility Validation
Internal Enterprise Use
Shoaib Ahmed
Lead QA / Test Automation Engineer
Specializations:
- Test Automation Architecture
- Playwright
- Selenium
- Accessibility Testing
- CI/CD Automation
- AI-assisted Quality Engineering
v1.3
- Accessibility Validation
- Content Validation
- Link Validation
- Screenshot Evidence
- State Registry
- Duplicate Detection
- ALT Text Validation
- Duplicate ID Validation
- Enterprise Reporting