Knowledge Base
Shopping Cart Software Online Manual
Troubleshooting Missing Images
The difference between templates and web pages Untranslated Red QuickCode Tags
Location Home > Shopping Cart Software Components > Administration Area > Design > FAQs & Tutorials

Troubleshooting Missing Images

Having trouble with blank, missing or broken images? A few possibilities as to why, as well as their solutions, are reviewed below:
Spaces and Special Characters

When uploading images, it is best to to avoid any formatting that involves spaces or special characters.

for example:
An incorrect example of an image file would be as follows:

picture example 40%.jpg

The corrected example of the same image file would be:


Images with spaces/special characters (such as the % sign) in the name will often result in a blank image.
Using incorrect file extensions

Another less common, but still occurring scenario that results in blank, black images, is when an incorrect file extension is applied to an image.

An example of this type of scenario would be having a .gif file, but giving it a .jpg file extension.


"But .jpg files are so much cooler!"


This type of action would result in a blank, black image in your store. For this reason, it is not suggested to name files with alternate, incorrect file extensions.
Wrong or incomplete file path

If the image uses a wrong or incomplete directory path, it will not be displayed. This can be as common as a typo, a missing or extra directory in the path, a missing slash (/), etc.

I insert an image into my HTML template:

<img src="" alt="">

It doesn't show up... Oh! It's because the image is actually located at:

<img src="" alt="">

In addition to the image path being incorrect, if the img tag or alt attribute have any errors, the image will fail to display.

I insert an image into my HTML template:

<img src="" alt=""

My image doesn't display correctly... What's up? Oh... I see, I forgot an ending bracket.

<img src="" alt="" >

more info
More information on HTML Images can be found at

Local Path vs Global Path

I put an image into my email template, and it now shows up as a Red X on the emails that I sent out. Please tell me how to make the image display in the email.

Images referenced in emails or on webpages must be linked globally (absolute path; with http://...) in comparison to locally (relative path; without http://...)

The Red X that is displayed when viewing the email is due to the image path within the email being a local path, compared to a global path.

To allow the image to show up in emails and on webpages, we will want to change the path to be global. This can be done by adding the full URL to the path, in comparison to the directories by themselves.

Globally (absolute):
<img src="">

Locally (relative):
<img src="/images/my_image.gif">


If a page is loaded in "https" and an image has "http" coded into its path, or vice-versa, in some web browsers the image will appear blank or broken. This is not definite, and can vary from browser to browser.

However, when viewing the Page Info of the webpage, the following will definitely be displayed:

The icon in the address bar will vary based on web browser.

This warning is due to the image not being loaded in "https".

This is due to the page being loaded in an "https" environment, but content on the page being loaded in "http". This can be corrected by editing the file path to match the environment it is be loaded in.

The checkout page of my store will always be loaded in "https". I have just inserted an image on this page using the following path:

<img src="" alt="">

My image doesn't show up? Why am I getting this weird notification in the Page Info? Ahh, that's right, the page is being viewed in an "https" environment, and so the image must also be loaded in https:

<img src="" alt="">

— Last Edited - 06/4/2013 4:49pm PDT
Rank and add a comment to this article
Only logged in users may leave comments and rank articles. Log in to have your say!
  Knowledge Base Home

  QuickCode™ Tag Glossary

  Modular Homepage

Not Logged in.
Either Log in or create a User Account.

Other articles in this category...

Add "Search by Price" links to the storefront

Add a "Terms of Service" agreement to a store page

Add a favicon

Add images to an email template

Adding a Company Name field to the storefront

Can QuickCode Tags Be Used in PHP Statements?

Can QuickCode Tags be used on non-store webpages?

Common customizations for the Order Receipt email

Copy a template package

Create a custom version of any QuickCode Tag

Create reusable headers/footer with Custom QuickCode Tags

Creating a Customer Registration Form

Creating templates with content viewable only by specific Customer Groups

Customize the category template to display subcategories in a grid

Customize the navigation header of a responsive template

Customize the navigation header of a responsive template

Customize the tabbed content area of a responsive product template

Disabling featured product display

Display a message if a customer has already purchased a product

Display a slideshow on any store page

Display sale prices in red text

Have your store match a website that links to it

Introduction to editing responsive template packages

Link your company logo to a different website

List of available Templates for use in Template Packages

Playing Flash video instead of downloading it

Require service agreement when a specific product is purchased

The difference between templates and web pages

Troubleshooting Missing Images

Untranslated Red QuickCode Tags

Using "Add to Cart" links on your website.

Using comments in Custom QuickCode Tags

Using the Custom Webpage Editor to add links to your Storefront

Your storefront on smartphones & mobile devices

Creating Template Packages: Part 1 of 4

Creating Template Packages: Part 2 of 4

Creating Template Packages: Part 3 of 4

Creating Template Packages: Part 4 of 4