HTML Email Debugger avatar

HTML Email Debugger

Pricing

from $20.00 / 1,000 analyses

Go to Apify Store
HTML Email Debugger

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

Enos Melo

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

11 days ago

Last modified

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?

  1. You provide the HTML code of your email (or URL to a template)
  2. The Actor parses the HTML and extracts all CSS properties and elements used
  3. Compares each property with the Can I Email compatibility database
  4. Checks best practices specific to email marketing
  5. Extracts all links (URL, text, anchor) and images (src, alt, dimensions)
  6. Can compare with previous run to show improvements or regressions
  7. Generates a complete report with all issues and suggestions

Input

FieldTypeDescription
htmlContentstringComplete HTML code of the email to analyze. Can be a full email (with <html>, <head>, <body>) or just a fragment. Max recommended size: 500KB.
inputUrlstringPublic URL of an HTML page for the Actor to fetch and analyze. Useful for pointing to a hosted template. Mutually exclusive with htmlContent.
emailClientsarrayWhich email clients to include in the report. If not provided, checks all 10 priority clients.
severityFilterstringFilter report by minimum severity level: "all" (default), "warning", or "critical"
includePassingChecksbooleanIf true, also includes properties that passed (supported in all selected clients). Useful for complete audits.
outputFormatstringOutput format: "detailed" (default), "summary", or "matrix"
compareWithPreviousRunstringRun 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:

  1. 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 compareWithPreviousRun is provided, shows score diff, new issues, and resolved issues
  2. 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

  1. Marketing agencies: Validate dozens of emails per month before sending
  2. Frontend developers: Ensure templates work across all clients
  3. Product teams: Improve email view rates for communications
  4. Consultants: Deliver professional email audits automatically
  5. 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).