Images in Email Templates

In some cases, customers may report that images in emails sent from your site are hidden or that the email shows a warning such as “This message appears suspicious” in Gmail, Outlook, or other email clients.

These issues generally fall into one of the following three cases. For a more detailed explanation, including background information and extended troubleshooting guidance, please refer to the full Knowledge Base article

Case 1: Images Require User Action to Display

What You See

  • Images are included in the email but are not shown automatically. The recipient may see messages such as:
  • “Images are hidden”
  • “Click here to display images”
  • “Display images below”

Once the user allows images, they appear correctly.

Why This Happens

Many email clients block images by default as a security measure to protect users from tracking or potentially harmful content. This often occurs when:

  • The sender is not yet fully trusted
  • The recipient has not interacted with emails from the sender before
  • Images are loaded from external sources

This behavior is common and does not necessarily indicate an error.

Suggested Solutions

You may consider:

  • Contacting your email service provider for guidance
  • Reviewing or adjusting email service settings
  • Using a hosting service that is compatible with the receiving email servers
  • If you’re using SVG images, converting SVG images to more common formats (such as PNG or JPG) before adding them to email templates

Case 2: The Mail Server Does Not Support the Image Format

What You See

Images do not appear at all, even after the recipient attempts to allow or display them.

Why This Happens

Some email services do not support certain image formats inside emails. For example, SVG images are often blocked or ignored due to security and compatibility limitations. Each email provider supports a different set of image formats.

Suggested Solutions

You may want to:

  • Review the documentation of the email service being used
  • Check which image formats are supported
  • Convert unsupported formats to widely supported ones
  • Commonly supported formats include:
    • PNG
    • JPG / JPEG

Using supported formats often resolves the issue.


Case 3: Images Blocked Due to Email Trust or Authentication Factors

What You See

Images are blocked and the email may display warnings such as:

  • “This message appears suspicious”
  • “Images in this message are hidden”

The behavior may vary between email providers.

Why This Happens

Email providers perform multiple trust and security checks before loading external content. Images may be blocked when the email fails or partially fails these checks, such as:

  • Missing or misconfigured email authentication (SPF, DKIM, DMARC)
  • Sender email address does not match the website domain
  • Images loaded from unsecured (HTTP) or untrusted sources
  • Server or hosting limitations affecting email reputation

If these factors reduce the trust score of the message, images may be blocked by default.

Suggested Solutions

You may consider:

  • Reviewing and configuring SPF, DKIM, and DMARC records
  • Sending emails from an address that matches your domain
  • Ensuring all images are served over HTTPS from trusted sources
  • Using an authenticated SMTP service instead of the default WordPress mail function
  • Testing email delivery across different email clients