Troubleshooting broken graphical image links

Troubleshooting Broken Image Links (and Hyperlinks)

While this article was specifically written to diagnose problems with broken images, it also applies to problems of broken links, in general.

There are three possible reasons why your images are not showing up on your pages as expected: (1) The image file is not located in the same location that is specified in your IMG tag; (2) the image does not have the same file name as specified in your tag; and 3) the image file is corrupt or damaged.

Broken links or images cannot be caused by problems on the server side. They can only be caused by incorrect HTML coding or errors in uploading image files to our servers.

GETTING STARTED -- What's the Browser Looking For?

Troubleshooting broken images should begin with the following step:

1. Position your cursor over the broken image and right-click your mouse. A popup menu should appear with several options.
2. Left-click on the option to view Properties. The Properties dialog will display the Address/URL of the image as it is defined in your HTML page. It should look similar to this:
3. Obviously, you want to substitute your domain name, subdirectory, and image file names where appropriate. The two most common image formats in use on the web today are GIF and JPEG, so your image will, more than likely, end with either the .gif or .jpg extension.

The URL that is displayed in the property dialog shows the location that your web page is telling browsers to look for the image. Write down the path, or copy and paste it into your favorite text editor so that you can refer to it later.

NEXT STEP -- Verify the Image Filename and Location

1. Now that you know where the image is supposed to be and what it's supposed to be named, verify that it's there. Go to your control panel and click on 'File Manager'. You will need to click on the www folder. The path represented by "" is your "www" directory, so the first place to go is to that directory.
2. You can also use your FTP or Telnet (SSH), log in to your account and navigate to the directory named in the path you've identified above. When you first log in to your account, you will be in your "root" or "system" directory (unless you have your client configured to automatically open in a subordinate directory.) With FTP, just double-click on the directory named "www". In telnet (SSH), issue the UNIX "cd" command. Type the command "cd www" (without the quotes) and hit enter.
3. Continue navigating in this way until you reach the subdirectory (myimagedir in the example above) in which your image (myimage.gif in the example above) is supposed to be found. Once you're there, try to locate your image file (myimage.gif in the above example). FTP clients will automatically display all the files located in the current directory. In telnet (SSH), to get a directory listing, type "ls -a" (without the quotes) and hit enter.

Chances are that by now you've discovered the problem. If the image file's not there, either put it there by clicking 'upload' in your File Manager or adjust your image tag so that it reflects the correct location.

Here are some important things to remember:

1. UNIX is CASE SENSITIVE. As far as our servers are concerned, myimage.gif, MyImage.gif, and myimage.GIF are three completely different files. Check your file name -- the filename in your directory and the filename in the path included in your web page must match EXACTLY. If they don't, change one or the other so that they do.

2. The case sensitivity issue holds true with directory names, too. MyImageDir and myimagedir are treated as two distinct directory names. Make sure the directory names match, too.


If the system path of the image file matches the URL of the browser path *exactly*, and the image still doesn't show, then the image file may be damaged or corrupt. Make sure the image loads on your local computer (try it out in your browser) and then upload it again (in BINARY mode, if using FTP).

If it still doesn't work, contact our Help Desk to open a technical support call.

Add Feedback