HTML Email Debugger
Pricing
from $20.00 / 1,000 analyses
HTML Email Debugger
Analyze CSS in emails and identify compatibility issues with major email clients like Gmail, Outlook, and Apple Mail. Includes link and image extraction with historical comparison to track improvements over time.
Pricing
from $20.00 / 1,000 analyses
Rating
0.0
(0)
Developer
Enos Melo
Actor stats
0
Bookmarked
2
Total users
1
Monthly active users
11 days ago
Last modified
Categories
Share
Analyze CSS in emails and identify compatibility issues with major email clients like Gmail, Outlook, and Apple Mail. Includes link and image extraction with historical comparison to track improvements over time.
What does this Actor do?
The HTML Email Debugger analyzes the HTML code of an email marketing campaign and automatically identifies which CSS properties and HTML elements are not supported by major email clients. It checks compatibility with Gmail, Outlook (all versions), Apple Mail, and Yahoo Mail, generating a detailed report with:
- List of issues found, classified by severity (critical, warning, info)
- Practical suggestions for fixing each problem
- Compatibility matrix showing support per client
- Score (0-100) and grade (A-F) indicating email quality
- Visual HTML report for easy analysis
- Extracted links and images for audit purposes
- Historical comparison to track improvements between runs
How does it work?
- You provide the HTML code of your email (or URL to a template)
- The Actor parses the HTML and extracts all CSS properties and elements used
- Compares each property with the Can I Email compatibility database
- Checks best practices specific to email marketing
- Extracts all links (URL, text, anchor) and images (src, alt, dimensions)
- Can compare with previous run to show improvements or regressions
- Generates a complete report with all issues and suggestions
Input
| Field | Type | Description |
|---|---|---|
| htmlContent | string | Complete HTML code of the email to analyze. Can be a full email (with <html>, <head>, <body>) or just a fragment. Max recommended size: 500KB. |
| inputUrl | string | Public URL of an HTML page for the Actor to fetch and analyze. Useful for pointing to a hosted template. Mutually exclusive with htmlContent. |
| emailClients | array | Which email clients to include in the report. If not provided, checks all 10 priority clients. |
| severityFilter | string | Filter report by minimum severity level: "all" (default), "warning", or "critical" |
| includePassingChecks | boolean | If true, also includes properties that passed (supported in all selected clients). Useful for complete audits. |
| outputFormat | string | Output format: "detailed" (default), "summary", or "matrix" |
| compareWithPreviousRun | string | Run ID of a previous analysis to compare with. Get this from Apify Console URL. If provided, output includes comparison with previous results. |
Supported Email Clients
- Gmail (Webmail)
- Gmail (iOS)
- Gmail (Android)
- Outlook 2016 (Windows)
- Outlook 2019 (Windows)
- Outlook 365 (Windows)
- Outlook 365 (Mac)
- Apple Mail (macOS)
- Apple Mail (iOS)
- Yahoo Mail (Webmail)
Output
The Actor generates two outputs:
-
Dataset: JSON object with complete report including:
- Issues found with severity, description, suggestions
- Compatibility matrix per client
- Score (0-100) and grade (A-F)
- HTML structure report (table layout, max-width, meta tags, etc.)
- Extracted links: Array of
{url, text, anchor}for each<a>tag - Extracted images: Array of
{src, alt, width, height}for each<img>tag - Comparison (optional): When
compareWithPreviousRunis provided, shows score diff, new issues, and resolved issues
-
Key-Value Store: Visual HTML report that can be opened directly in a browser, with large score display, severity counts, and color-coded compatibility table.
Example Output
{"summary": {"overallScore": 91,"overallGrade": "A","criticalCount": 1,"warningCount": 0,"infoCount": 1},"extractedContent": {"links": [{ "url": "https://example.com", "text": "Visit our site", "anchor": null },{ "url": "https://example.com/contact", "text": "Contact Us", "anchor": "contact-link" }],"images": [{ "src": "https://example.com/logo.png", "alt": "Logo", "width": 200, "height": 100 }]},"comparison": {"previousScore": 85,"scoreDiff": 6,"issueChanges": [{ "type": "resolved", "issue": { "id": "iss-001", "property": "margin" } }]}}
Use Cases
- Marketing agencies: Validate dozens of emails per month before sending
- Frontend developers: Ensure templates work across all clients
- Product teams: Improve email view rates for communications
- Consultants: Deliver professional email audits automatically
- E-commerce: Integrate with CI/CD to validate transactional templates
Pricing
Each analysis costs approximately $0.02 per 1000 results (Apify's pay-per-result pricing). The Actor generates one result per email analyzed.
Compare: Litmus and Email on Acid charge $99+/month for similar functionality.
Known Limitations
- Does not perform visual rendering (code analysis only)
- Does not check specific spam content
- Does not test link functionality (only validates they are present)
- Compatibility data is updated periodically
Roadmap
Coming soon:
- Auto-fix suggestion (generates corrected HTML)
- Mailchimp/Klaviyo integration to analyze templates directly
- Webhook notifications when analysis completes
License
This Actor uses data from Can I Email (MIT license).
