Back to Community

Troubleshooting Blurry or Missing Product Images in Mailchimp for WooCommerce

33 threads Sep 9, 2025 PluginMailchimp for woocommerce

Content

One of the most common issues users face with the Mailchimp for WooCommerce integration is product images appearing blurry, pixelated, or missing entirely in campaigns and product blocks. This guide will explain why this happens and walk you through the most effective troubleshooting steps to resolve it.

Why Do Product Images Appear Blurry or Incorrect?

Based on community reports, this problem can stem from several sources within the integration:

  • Image Size Settings: The plugin allows you to select which WordPress image size is sent to Mailchimp. If this is set to a small size like the default 'thumbnail', the image will be low resolution when Mailchimp displays it.
  • Sync Timing: Changing the image size setting does not automatically update the images for products already in your Mailchimp catalog. A manual resync is required.
  • Hotlinking Protection: Server-side security rules in your .htaccess file can block Mailchimp's servers from accessing and displaying your images, showing a 'hotlinked' error instead.
  • Plugin or Theme Conflicts: Occasionally, other code on your site can interfere with how the plugin generates and sends image URLs to Mailchimp.

Step-by-Step Troubleshooting Guide

1. Adjust the Image Size and Resync

This is the first and most crucial step.

  1. In your WordPress admin, go to WooCommerce > Settings > Integration > Mailchimp.
  2. Locate the 'Product Image Size' setting.
  3. Change the selection from a small size like 'Thumbnail (300x300)' to a larger size like 'Large (1024x1024)' or 'Full Size'. The 'Large' size is often a good balance between quality and load time.
  4. Save the changes.
  5. Resync your products: To push the new image size to Mailchimp, you must trigger a resync. You can do this by editing and saving a few products in your WooCommerce catalog. The plugin's hooks will then send the updated product data, including the new image size, to Mailchimp.

2. Check for Hotlinking Restrictions

If your product images are completely missing or showing a 'hotlinked' error, your server may be blocking external requests. Mailchimp's servers need to access your images to display them in emails.

Review your site's .htaccess file. If you have rules to prevent hotlinking, you must add an exception for Mailchimp's domains (e.g., mailchimp.com). The provided code snippet in the sample threads is an example of such a rule, but it must be correctly implemented for your specific server environment.

3. Enable Debug Logging

If the issue persists, enable debug logging in the plugin to see what image data is being sent.

  1. In the Mailchimp for WooCommerce settings, navigate to the 'Logs' tab.
  2. Set the log preference to 'Debug' and save.
  3. Edit and save a product that is having image issues.
  4. Return to the Logs tab and review the entries. Look for the image URLs the plugin is submitting. This can help you verify if the correct, high-resolution image URL is being sent.

4. Check for Browser Extensions or Caching

In one reported case, the issue was caused by a browser extension. Try viewing your Mailchimp campaign in an incognito/private browser window or a different browser to rule this out. Also, clear your browser and site cache.

When to Seek Further Help

If you have tried all the steps above and the problem continues, the issue might be more complex. The Mailchimp for WooCommerce plugin has a 'Remote Diagnostics' feature that can help their development team investigate.

You can enable this option under WooCommerce > Settings > Advanced > Mailchimp. Providing specific details like a product ID or a screenshot of the issue can significantly help if you need to ask for further assistance from the plugin's support channels.

By methodically working through these steps, most users can resolve image quality issues and ensure their products look their best in Mailchimp campaigns.

Related Support Threads Support