Help:Linking to files/en

First learn
Before you can link to files, you first need to know the basics of:

Not the same as embedding
This help page is about linking to files. Don't confuse that with embedding an image file in a page. Although they're both ways of using files, they're not the same.

Embedding an image file for example, might be having a person's picture appear alongside the text on a page about that person. For information on how to embed an image, see.

Why link?
In some situations, you don't want the file to be embedded in another page. You want a link on the page to take you to the file description page of a particular file. Or you may want the link to take you to the file itself. Here are some examples where you likely want to link rather than embed:


 * a file of a type that cannot be embedded in a page (for example, a spreadsheet -- assuming the wiki allows such file types to be uploaded at all).
 * a file may be an image that is so large it's only useful on its own page (for example a detailed map).
 * you want to refer the readers to where they can download or replace the file.

Link to a file description page
You can create a link to a file's file description page by using a colon before  :

Note that if you forget to use the initial colon, you will instead be embedding an image.

Link to actual file
You can use the pseudo-namespace "   " to link to the actual file on MediaWiki pages. The link will not take you to the file description page, but instead will deliver the file itself.

(If the above pattern actually produces a text link to the file description page, instead of the expected link to the actual file, it may be that your wiki's namespaces are configured out of compliance with this feature.)

Direct links from external sites
Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

The parameters  and   can also be added to return a specific size of the image. The image aspect ratio is always preserved.