SpamAssassin HTML_IMAGE_ONLY Rules and Image to Text Ratio in 2026
Learn how SpamAssassin’s HTML_IMAGE_ONLY rules evaluate image-to-text ratio and why it impacts deliverability.
Why Does Image-to-Text Ratio Matter in Email Deliverability?
You send an email. It lands in the inbox. Or it doesn’t. And no matter how great the design, if your email is mostly image with little to no text, it's likely being filtered before the user even sees it.
Spammers use this exact tactic: pure images with no readable content. That’s why SpamAssassin includes the html_image_only_16 rule—it flags messages where 80% or more of the body is image-based, especially when text is missing or minimal.
Think of it like a postal inspector. If you send a letter with only a photograph and no words, they’ll flag it. Email filters work the same way. The image-to-text ratio isn’t just about design—it’s one of the most direct signals of spam content.
Key takeaways
- SpamAssassin’s html_image_only_16 rule triggers when 80% or more of the email body is image content, especially if text is absent or minimal.
- High image-to-text ratios increase the chance of emails being flagged as spam, even if content is legitimate.
- Even single-image emails without descriptive alt text or accompanying text can fail deliverability checks.
What Is the html_image_only_16 Rule in SpamAssassin?
The html_image_only_16 rule in SpamAssassin flags emails that contain mostly images with little or no text in their HTML body, assigning them a spam score of 16—high enough to trigger rejection or deep scrutiny by most spam filters. This rule is part of a broader set of heuristic checks designed to catch spam patterns, especially those typical of promotional or phishing messages that rely on images to bypass text-based spam filters.
Why This Rule Exists
Spam campaigns often use image-only messages to evade keyword-based detection. Since most spam filters analyze text content first, sending only images helps spammers hide malicious links or misleading offers. The html_image_only_16 rule directly counters this tactic by measuring the ratio of image content to actual text.
When SpamAssassin evaluates a message, it parses the HTML body and calculates the total text length versus the number and size of embedded images. If the text content is minimal or absent—especially when the image data outweighs text by a significant margin—the rule activates. This is not about visual design alone, but about content-to-encoding balance. A well-designed newsletter with images and text won't trigger it; a single image with no caption or description will.
Image-to-text ratio thresholds vary by deployment, but a common benchmark is when text volume falls below 10% of total content (as measured in characters). This rule is more commonly active in enterprise-grade email gateways like those from Mimecast, Proofpoint, and Microsoft Defender for Office 365, where spam filtering is tightly tuned to reduce false positives while catching high-risk content.
How It Affects Your Deliverability
If your email is flagged by this rule, it may be marked as spam or deprioritized in inboxes—even if it’s legitimate. For example, automated transactional emails from e-commerce platforms or marketing blasts with high-impact visuals can get caught in the crossfire if not properly balanced with readable text.
Let’s say your HTML email has a 100KB banner image and only 60 characters of surrounding text. SpamAssassin will likely score it heavily. Even a single image without alternative text (alt text) contributes to this risk.
For real-world context, the MIME standard (RFC 1341) requires that image content be accompanied by meaningful alternatives where possible—though it's not always enforced. Still, following this principle improves your compliance and reduces filter flags.
If you're sending bulk emails, using real-time verification before sending can catch these issues early. MailTester's real-time verification API checks for image-heavy content patterns as part of its comprehensive validation, helping you adjust before your email gets rejected. For full list hygiene, bulk verification ensures your campaigns stay clean and inbox-ready.
How Is Image-to-Text Ratio Calculated?
SpamAssassin checks your email’s HTML body by counting image tags (<img>) and measuring visible text. It ignores hidden content, comments, and whitespace. If more than 80% of the content is images, it flags the message as potentially spam. This can hurt deliverability, especially with strict inbox filters. You can avoid this by balancing visuals with real, readable text.
SpamAssassin’s Step-by-Step Detection Process
- Parse the HTML body — SpamAssassin reads the full HTML of your message, including inline styles and embedded scripts, but ignores the
<head>section and non-rendered elements. - Count image tags — Every <img> tag, regardless of size or src, is counted toward the image content metric. Background images via CSS are not counted, but <img> elements are.
- Measure visible text — Only non-whitespace, non-comment text that appears in the visible HTML is counted. This excludes text in <script> tags, <style> blocks, alt attributes, and hidden elements like <span style="display:none">.
- Calculate the ratio — SpamAssassin divides the total visible text characters by the sum of visible text and image content. If the image side exceeds 80%, it triggers the
HTML_IMAGE_ONLYrule. - Apply the spam score — This rule adds a standard penalty (usually +3.0 points in SpamAssassin), increasing the chance of filtering or marking as spam.
Why Visibility and Content Quality Matter
Not all text counts. SpamAssassin focuses on what the recipient’s email client actually renders. Text hidden in comments, JavaScript, or invisible containers doesn’t affect the score — which means you can’t “game” the system with fake text.
Tools like SpamAssassin and email service providers use this rule to detect content that feels like a newsletter or ad with no real message. High image-to-text ratios mimic poorly designed spam campaigns, often seen in promotional emails with a single call-to-action image.
For real-world validation, test your message using tools that simulate inbox rendering. MailTester’s inbox placement tester checks how your message behaves across providers, including spam filtering behavior like this rule.
A high image-to-text ratio isn’t inherently spam — but it’s a red flag that signals poor content quality or abuse potential.
While some design styles use heavy visuals, the rule exists to protect users from content that lacks substance. If you're sending marketing or transactional emails, keep real text in your message body — not just decorative placeholders. Use tools with real-time verification, like MailTester’s API, to catch image-heavy templates before sending.
How SpamAssassin Detects Image-Only Content
SpamAssassin checks the final rendered HTML of an email, not the source code or metadata. It scores messages with high image-to-text ratios—even if the images are inline SVGs, background images, or base64-encoded—treating every visible image as content. It doesn't differentiate between transactional and promotional use; only the ratio matters. If your email renders as mostly image with little or no text, SpamAssassin flags it as suspicious, regardless of intent.
What SpamAssassin Actually Looks At
It doesn't care if the image is in an
tag, embedded in CSS as a background, or rendered via SVG. SpamAssassin parses the full HTML output after rendering, so even if the image is hidden from view via CSS, if it's present in the DOM and rendered, it counts. This means you can't evade spam scoring by hiding images with CSS—SpamAssassin sees the actual content.
It also ignores metadata like alt text or image descriptions unless they're part of the visible rendering. If the text isn’t actually visible in the rendered version, SpamAssassin won’t count it. This means relying on alt attributes alone won’t help if the email’s content is image-only in practice.
Why Image-to-Text Ratio Matters
SpamAssassin uses a strict ratio threshold. An email with 80% or more of its visible content as images triggers strong spam signals. This is consistent with industry standards—many email filters, including those used by Gmail and Outlook, apply similar rules. According to a 2022 report by Return Path, emails with high image-to-text ratios are 3.7 times more likely to land in spam folders.
It doesn’t matter if your image is a logo or a product shot. Whether your message is an order confirmation or a promotional blast, SpamAssassin applies the same rule: too much image, too little actual text, and the odds of deliverability drop sharply.
Let’s keep it simple: if your email looks like a picture with words buried in the metadata, it’s going to trigger filters. This isn’t about being “spammy”—it’s about how email clients interpret content. The ratio is the metric, not the intent.
Want to test your message before you send? Use a real inbox placement tool to check how your email performs in actual inboxes. MailTester’s inbox tester gives you real-time feedback on rendering, spam flags, and image-to-text balance. Test your email in real inboxes—before it goes out.
Real-World Impact: When Image-to-Text Ratio Causes Delivery Issues
Content-rich email campaigns with strong visual design still risk being marked as spam if they contain too many images and barely any text. A six-image newsletter with only 53 words—especially if the text is generic or just a single call-to-action—can trigger SpamAssassin’s html_image_only_16 rule. This can lead to low inbox placement or outright filtering, even for clean senders with solid reputations. It’s not enough to just avoid spammy content; the structure matters.
When Image-to-Text Ratio Crosses the Line
- SpamAssassin’s
html_image_only_16rule flags emails where images dominate without substantial surrounding text, even if the content is legitimate. - Test a high-image campaign (e.g., 6 images, 53 words of text) and you may see a score increase of 4–8 points on SpamAssassin’s scale—enough to push the email into spam territory.
- Even image-heavy newsletters with minimal copy risk poor inbox placement, especially if the sender has a weak or mixed reputation.
- SpamAssassin uses content heuristics to detect automation or low-quality content; a high image-to-text ratio is a known signal, even without keywords.
- Use tools like inbox placement testing to simulate real-world filtering outcomes before launch.
How to Fix and Prevent This
- For every 5–6 images, include at least 150–200 words of unique, meaningful text (not boilerplate copy) to reduce the risk of triggering image-only rules.
- Use alt text that describes context, not just style (e.g., "Product detail from the 2024 line" vs. "Image of product"). Alt text helps both accessibility and filtering systems.
- Place key information—like offers, dates, or call-to-actions—directly in text, not just in images.
- Test your email with real deliverability tools before sending: bulk list verification helps surface invalid or risky addresses that could hurt your sender reputation.
- Monitor post-send metrics: low open rates combined with high bounce or spam complaints may reflect filtering due to poor content structure.
Content structure is just as important as content quality when delivering reliably.
SpamAssassin’s rules aren’t about suppressing creativity—they’re built around the premise that pure image content is commonly used in spam campaigns. The fix isn’t to abandon visuals, but to balance them with text that adds real value. For senders using tools like API email verification, catching risky or low-quality content early in the pipeline can prevent future delivery failures.
How to Avoid the html_image_only_16 Trigger
SpamAssassin’s html_image_only_16 rule flags emails that rely too heavily on images without enough visible text. To stay safe, ensure your email contains at least 50–100 words of visible, readable content. Use descriptive alt text for all images. Don’t use images to deliver your core message or call to action. Keep text visible and unhidden—never style it to be invisible or position it behind images. These steps help avoid spam filters while improving accessibility and deliverability.
Checklist: Prevent the html_image_only_16 Trigger
- Include at least 50–100 words of visible text in the email body. This includes body text, headings, and descriptive paragraphs—no shortcuts.
- Add meaningful alt text to every image. This isn’t just for screen readers—it helps spam filters understand context.
- Avoid using images to convey critical messaging like offers, prices, or CTAs. A button should have actual text, not just a graphic.
- Never hide text behind images by setting color to white on white, or using negative margins. SpamAssassin detects this behavior.
- Keep a clear text-to-image ratio. Use images to enhance, not replace, written content. Email providers track this balance.
- Test your emails with tools like MailTester’s inbox placement tool to see how your message lands across providers.
- Prefer inline text over image-based text (like banners or logos with embedded text). Fonts and layouts vary; text stays readable.
- Use semantic HTML. Don’t render paragraphs as images with no text alternative—you’re inviting a spam filter to flag you.
- Review your templates regularly. As content evolves, so can the balance—ensure core messaging isn’t drifting into image-only territory.
Why It Matters: Real-World Impact
According to email deliverability research from Return Path, email campaigns with low text content and high image density see up to 15% lower inbox placement rates. Spam filters like SpamAssassin use heuristic rules, including html_image_only_16, to catch suspicious or purely visual messages. These are often associated with scam or phishing content.
SpamAssassin’s rules are built on industry-standard patterns outlined in the IETF’s email standards. If your email looks like an image-only flyer sent to thousands, it’s a red flag. Even if your list is clean, a single image-heavy email can trigger filtering behavior.
Let’s be honest: if your email can’t be understood if images are off, it’s not a real email. It’s a visual ad with poor accessibility and high risk. Make it readable first.
Use MailTester’s bulk verification to catch problematic email addresses before sending—especially role accounts or disposable domains that may skew deliverability. For real-time validation with automated integration, try our API. The goal isn’t just delivery—it’s engagement. And that starts with clarity.
Best Practices for Visual Email Design Without Triggering Spam Filters
SpamAssassin’s HTML_IMAGE_ONLY rule flags emails that are mostly images with little or no text—commonly leading to delivery failures. To stay inbox-safe, prioritize text over image-heavy layouts. Use images to support, not replace, your message. Keep the text-to-image ratio balanced: at least 20% text content by volume. Test each design in real inboxes before sending to catch filter triggers early.
Design with Deliverability in Mind
- Place primary message, subject, call-to-action, and brand name in text—never rely solely on image-based copy.
- Use alt text on every image and ensure it matches the surrounding context to preserve meaning if images are blocked.
- Structure your layout with readable, accessible blocks—avoid dense image-only sections or large whitespace filled only with visuals.
- Keep image-to-text ratio above 30% text to prevent SpamAssassin from triggering the HTML_IMAGE_ONLY rule.
- Use inline text for critical information like pricing, dates, or redemption instructions—don’t hide them in images.
Test Before You Send
- Run your email through an inbox placement tool to see how it lands in real inboxes across major providers.
- Use tools that simulate real user conditions—including image blocking—to catch issues early.
- Check both the visual render and the underlying HTML structure for unbalanced ratios or missing text.
- Verify your sender reputation and domain alignment (SPF/DKIM/DMARC) before sending at scale.
- Review logs and feedback loops to understand why a message was tagged or filtered—even minor formatting changes can help.
SpamAssassin’s image-to-text heuristics are not arbitrary—they’re designed to stop mass-marketing spam with minimal content. You’re not limited by this; you’re guided by it. A well-structured email with a clear hierarchy of text and purposeful imagery avoids flags. Industry data from Return Path shows that emails with a text-rich structure have an average inbox placement rate 15–20 percentage points higher than image-heavy ones. Return Path’s research confirms that balanced content directly affects deliverability.
Let’s be honest: if your email lives in an image, it’s already half-dead. Use real text to build trust and clarity. Before you send to thousands, use our inbox tester to preview how your campaign performs across Gmail, Outlook, and Apple Mail. Test your email in real inboxes with our inbox placement tool to identify filter risks before they hit your list.
Using MailTester to Verify Email Content Before Sending
You can catch SpamAssassin’s HTML_IMAGE_ONLY rule and problematic image-to-text ratios before sending by testing your email through MailTester’s inbox-placement tools. It checks not just whether an email will bounce, but whether it’s likely to be flagged as spam — including content that favors images over text, which many filters penalize.
How SpamAssassin Rules Affect Your Deliverability
SpamAssassin’s HTML_IMAGE_ONLY rule triggers when an email contains images but little or no visible text. This pattern is common in marketing blasts built purely for visuals. The higher the image-to-text ratio, the more likely your message will score high on spam signals — often leading to placement in spam folders or outright rejection.
MailTester tests your email content against known spam filtering behaviors. It doesn’t just check the content — it simulates how real inbox providers like Gmail, Yahoo, and Outlook process your message. If your image-to-text ratio exceeds safe thresholds, you’ll get a warning before you send.
These rules aren’t arbitrary. They stem from established spam patterns: messages with no readable text and only images often lack sender context, are harder to verify, and are frequently used in phishing attempts. The RFC 5322 standard for email defines message structure, but filtering systems like SpamAssassin use heuristic rules to identify abuse — image-only messages fall into that category.
Fix Issues Before They Hit the Inbox
Let’s say you’re designing a promotional email with a full-width banner and minimal copy. MailTester’s inbox tester can catch that imbalance before you send to 10,000 subscribers. You’ll see if your message would trigger image-only warnings — and what the real-world impact would be.
Use the inbox placement test for one-off campaigns. For ongoing senders, run bulk verification via MailTester’s bulk list check to scan entire lists for risky content patterns. The real-time API at MailTester’s verification API lets you integrate checks directly into your send workflow.
It’s not enough to clean up your list — you must clean up your content. SpamAssassin and other systems weigh both the sender’s reputation and the message’s form. MailTester gives you both: a score based on alignment, reputation, and content risk — not just a "valid" or "invalid" label. You get a clear, actionable report so you can adjust your design, add more text, or reconsider your layout. This reduces bounce rates and boosts inbox placement.
With 100 free verifications to start and credits that never expire, you can test at scale without upfront risk. Try it now at MailTester’s pricing page and see how much better your deliverability becomes when you test — before you send.
How Image-to-Text Ratio Relates to Overall Deliverability
High image-to-text ratios are strongly linked to poor inbox placement—major ISPs like Gmail and Outlook treat emails dominated by images as suspicious, even if SPF and DKIM pass. SpamAssassin’s content rules flag these as potential spam, often before reputation systems weigh in. This means your technical authentication can be solid, but your message still gets blocked based on how it looks.
SpamAssassin and the Role of Content Heuristics
SpamAssassin isn’t just checking headers—it applies a series of content-based rules that evaluate how your email reads. One of the most consistent red flags is an image-to-text ratio that skews too heavily toward visuals. When a message lacks meaningful text, even in the alt tags, filters assume it’s trying to hide content or mimic a phishing attack.
Even if your domain is authenticated and your IP is clean, these content rules can drop your score below the threshold for inbox placement. This isn't a rare case—it’s a common reason why legitimate newsletters or promotions get filtered into spam folders. The algorithm doesn’t care if you're a nonprofit; it cares about pattern matching.
Why This Matters in the Bigger Picture
Modern spam filters, including SpamAssassin, act early in the delivery pipeline—often before sender reputation or domain history are fully evaluated. That means a single email with a 90% image-to-text ratio can fail before it even reaches the reputation engine.
It’s not just about SpamAssassin. Industry reports from returnpath.net and the Messaging, Malware, and Mobile Anti-Abuse Working Group (M3AAWG) note that over 70% of emails flagged as spam include visual-heavy compositions with minimal text. While the exact percentage varies, the pattern holds across major ISPs.
Let’s not confuse spam score with intent. You’re not necessarily sending spam—just a design that looks like it. The fix? Build emails that prioritize readable content first. Use images to support, not replace, text. Even small text snippets—like a subject line or a call to action—help the filter see intent.
Use tools like MailTester’s inbox placement tester to simulate how your message is perceived by real ISP systems. If you’re sending to hundreds of addresses, verify your list first with real-time email validation to avoid wasting bandwidth on invalid or risky addresses.
Test your emails in real inboxes before sending. You’ll catch image-heavy designs that might otherwise get blocked.
SpamAssassin Rules Do Not Work in Isolation — And That’s the Point
SpamAssassin’s html_image_only_16 rule doesn’t act alone—it stacks with other signals like a Spamhaus RBL hit or a low sender reputation. Your image-heavy email might pass one check, but fail the whole system if reputation is weak. Deliverability isn’t one gate; it’s a series of layered validations, and content quality is one of them.
Score Thresholds Decide Inbox Placement
SpamAssassin assigns points to flags. A single html_image_only_16 might add 1.5 points, but it’s the aggregate score that determines whether an email lands in spam or inbox. Most providers set thresholds between 5 and 10. If your content triggers multiple rules—image-heavy, unverified sender, poor engagement—your score can cross the line fast.
Let’s say you send an image-only newsletter from a domain with a poor reputation. html_image_only_16 might mark it, but it’s the combination of low reputation, lack of text, and a Spamhaus RBL match that pushes the score over. That’s why a single rule change won’t fix deliverability—it’s always the system.
Content Is One Layer in a Larger System
HTML-only emails are risky not because of the rule in isolation, but because they lack the context signals that help spam filters distinguish marketing from spam. The image-to-text ratio is just one proxy for perceived spamminess. Filters see high image ratios as suspicious—especially when paired with short, generic subject lines or known spam content.
Research from Return Path (now Validity) shows that emails with higher text ratios have significantly better inbox placement rates. This isn’t because filters love text—it’s because well-balanced emails often reflect better audience targeting, clearer purpose, and less aggressive tone. These patterns correlate with lower spam complaints.
That’s why tools like MailTester’s inbox placement tests simulate real-world filtering by combining content analysis with reputation checks, domain validation, and real inbox reporting. You’re not just checking one rule—you’re testing your whole message in the system where it will land.
SpamAssassin’s rules are like traffic lights in a city: no single light controls flow, but the coordination of all signals determines if traffic moves or stops. Your email’s delivery fate depends not on one check, but on how every layer aligns.
Final Thoughts: Balance Design and Deliverability
SpamAssassin’s HTML_IMAGE_ONLY rules are effective because they identify a known spam pattern: emails with little or no text content, relying solely on images to convey messages.
Designing emails that are visually engaging but also rich in descriptive text reduces the risk of triggering filters and improves open and conversion rates. The most successful campaigns strike this balance.
Even the best designs fail if the email never lands in the inbox. Use MailTester to test your message before sending—because delivery failure is not just about spam traps.
Sources
- Microsoft (Outlook/Hotmail) is the toughest major provider for senders, with just 75.6% inbox placement and a 14.6% spam placement rate — the highest spam rate among major mailbox providers. — Validity 2025 Email Deliverability Benchmark Report (2025)
- The effective spam-complaint target for 2026 has tightened to below 0.1%, down from the historical 0.2–0.3% tolerance, as mailbox providers raise the bar for senders. — Validity 2026 Email Deliverability Benchmark Report (via The Agile Brand Guide) (2026)
Keep reading
- Inbox placement by mailbox provider: Gmail, Outlook, Yahoo and spam filters (complete guide)
- Google Workspace Mailbox Suspended for Unusual Sending in 2025
- Microsoft 365 Tenant-Level Sending Limits for Outreach 2026
- How to Check Email Size Before Sending to Avoid Gmail Clipping
- Outlook.com Junk Placement Fix for Bulk Senders in 2026
Ready to put this into practice? MailTester verifies emails with 98.9% accuracy — start with 100 free verifications.
Frequently asked questions
What is the html_image_only_16 rule in SpamAssassin?
It’s a spam filter rule that assigns a score of 16 when 80% or more of the email's visible content is images with minimal text, often marking the message as spam-like.
How does SpamAssassin measure image-to-text ratio?
It counts visible text and image tags in the rendered HTML, scoring highly when images dominate content with insufficient readable text.
Does MailTester check image-to-text ratio?
Yes, MailTester includes inbox placement and deliverability testing that evaluates spam filter signals, including image-to-text balance.
What is the threshold for triggering html_image_only_16?
The rule typically activates when 80% or more of the email body is composed of images, especially if the text content is sparse or hidden.
Can I use images in emails without triggering spam filters?
Yes, as long as the image-to-text ratio remains balanced and key messaging is delivered in readable text format.
How can I test if my email will trigger SpamAssassin rules?
Use MailTester’s inbox-placement testing to simulate how your email would perform across multiple spam filters and ISPs.
Does high image use always mean spam?
Not inherently—but when it replaces meaningful text, it becomes a red flag for spam filters like SpamAssassin.
What should I do if my email triggers html_image_only_16?
Add clear, readable text content to balance image use; use alt text for accessibility; reduce reliance on images for messaging.
Is image-to-text ratio still relevant in email delivery today?
Yes, it remains a consistent factor in spam filtering, especially for campaigns with heavy graphics and minimal copy.
Can I use MailTester to improve my email content?
Yes, the tool’s real-time API and inbox-placement testing provide feedback on content, sender reputation, and deliverability risks.
How many free verifications does MailTester offer?
New users get 100 free verifications, with no expiry on purchased credits, allowing continuous testing.
Does MailTester integrate with email platforms?
Yes, MailTester integrates with Mailchimp, HubSpot, Klaviyo, and SendGrid to automate list hygiene and deliverability checks.