How to Troubleshoot Broken Email Newsletter Images

When configuring newsletters, you may want to use your own custom images and photos.

When you create your newsletter content, you can use HTML tags to display images within the message body. If you're unfamiliar with HTML, you can quickly upload and embed image files into your message using the Easy Editor on your store's newsletter configuration page.

Issues With Image File Names

While image files with spaces or punctuation (%, #, &, !, etc.) can be uploaded to your store, the links created using that file name may prevent your newsletter recipients from viewing the images. For best results, you should always name your image files without using spaces or punctuation so you won't need to rename them if you decide to use them in a newsletter.

For example, the following file name may cause problems:

my newsletter banner.jpg

So you should rename it as:


If you have a lot of files that need to be renamed, or regularly find yourself having to do so, you might look into using an application like Bulk Rename Utility.

Configuring Easy Editor Links

Note that the Easy Editor creates HTML links to display images it has uploaded to your store. When the Easy Editor performs this operation, it creates a link to your image files. For example, the Easy Editor will create a link to an image named, "newsletter_01.jpg" similar to the following:

<img src="/v/vspfiles/images/newsletter_01.jpg" border="0">

Even though you may be able to see your newly uploaded image within the message body (since you're already viewing your store, and the link created by the Easy Editor is related to your store's domain name), newsletter recipients will not be able to view the image within their mail applications or web services.

You can fix this issue by adding your store's domain name to the link the Easy Editor has just created.

Using the above example, if you've just uploaded an image to a newsletter you're configuring for, you should click the HTML button (</>) to view the link code and modify it so the link reads:

<img src="" border="0">

Configuring your image tag as described above will ensure that the image link will be valid for your newsletter recipients.

Additional Information

For further information on HTML editing functions, see How to Use the Easy Editor.