Help:Uploading files

From PathfinderWiki
Help contents
It is assumed that you are already familiar with basic wiki editing and that you know your way around a wiki.
Creating articles









Real-world Person

Using templates

Creating redirects

Converting from Wikipedia

Editing articles

Citing sources

Creating an index

Disambiguating subjects

Uploading and adding media

Moving 1E pages to 2E names



Permitted media


Creating category pages


Artwork and media






Magic Items



You can upload files to PathfinderWiki and embed them in articles. When a file is uploaded, PathfinderWiki creates a file page named after the filename and prefixed with "File:".

Information icon.jpg

When uploading images and other media to Pathfinder, follow the instructions on Special:Upload. Remember, you must provide a license that explains why you're allowed to upload the media here, and you should provide a link to its source whenever possible. Categorizing files with keywords helps others find them.

Supported file types and sizes

By default, the wiki allows you to upload files with certain extensions only:

  • Images
    • png
    • gif
    • jpg or jpeg
    • svg
  • Audio
    • mp3

The preferred formats are:

  • JPG for photographic images or images of detailed artwork with millions of colors and shades
  • PNG for fixed-color images such as icons, or for detailed images with transparency
  • SVG for structured vector drawings and logos
  • MP3 for audio

Files cannot be larger than 50MB.

Uploading a file

To upload a file, go to Special:Upload. In the menu on the left under "toolbox," this is the "Upload file" link.

Check the file's license

Before uploading, please ensure that you have rights to upload and redistribute the file in question, and that they comply with any further licensing requirements. Please note that as with wiki pages, others can edit or delete your uploads if they think it serves the project, and you can be blocked from uploading if you abuse the system.

MediaWiki automatically resizes images as appropriate, so upload the highest-resolution version of any image you want to upload. Note that the Community Use Policy prohibits resizing, cropping, or otherwise modifying any image provided under that license. The MediaWiki software handles images in a manner compliant with the CUP.

Make sure the file isn't already on the wiki

Search the wiki for the file name or the image's subject and make sure the image isn't already on the wiki. If it is, you might encounter an error while uploading it. You can also check the upload log and file list; links to them are under the File upload tools header of the upload page and batch upload page.

Select the file

Single files

On the upload page, scroll down to the "Browse..." button. Clicking it brings up your operating system's standard file open dialog. Choosing a file from your computer will fill the name of that file into the text field next to the button.

Provide a suitable file name. The file name you provide here before uploading it to the wiki doesn't need to be the same as the file name stored on your computer. Please name your files descriptively to avoid confusion and make sure that the file name has the proper extension. File names are case-sensitive—this applies even for the file name extension.

Multiple files

Sometimes it's more efficient to upload several files at once. You can do this on the batch upload page, which works a little differently from the single-file upload page.

Rename the files on your local computer to the file names you want them to use on the wiki before proceeding. Please name your files descriptively to avoid confusion and make sure that the file name has the proper extension. File names are case-sensitive—this applies even for the file name extension.

You can either select a group of files on your local computer, then drag and drop them onto the appropriate button on the batch upload page, or you can click the buttons and select the files from the window that appears.

After the files are uploaded, links appear for each uploaded file. Open each link in a new browser window or tab, then edit each file to complete the templates automatically added to each file.

Provide file information

In the summary section, add the {{File}} template and fill the appropriate fields. (For a sample template, scroll up and expand the Sample {{File}} template header.) This important template automatically and consistently formats information about files and categorizes files appropriately. For more information, consult the {{File}} template's documentation.

For example, an image of Valeros, the iconic fighter, uses the following {{File}} template to note:

  • the file's copyright holder and year
  • its artist
  • its print and web sources, if relevant
  • whether the image is used on a book's cover
  • a summary of the image
  • keywords for categorizing the image
| year     = 2007
| copy     = Paizo Publishing, LLC
| artist   = Wayne Reynolds
| print    = Burnt Offerings
| cover    = yes
| web      = {{Cite web
  | url    =
  | author = [[James L. Sutter]]
  | page   = Paizo Blog
  | date   = May 7, 2007
  | title  = Meet the Iconics: Valeros
| summary  = [[Valeros]], iconic [[human]] [[fighter]].
| keyword1 = Valeros
| keyword2 = iconics
| keyword3 = fighters
| keyword4 = humans
| keyword5 = full-body portraits

Choose a license

In the licensing dropdown, select an appropriate license. In general, images from Paizo blogs, product cover images from the Paizo store, and files from Community Use Packages use the Community Use Policy license for each type of image. For detailed help selecting a license, see the Project:Copyrights and Help:Copyright on images articles.

Watch for updates

You can also opt to add the file page to your watchlist to track it for updates made by other editors, by checking the "Watch the File" option before uploading. You might also check the "Ignore any warnings" box to bypass any messages. however, we recommend paying attention to any warnings that might appear.

Do it!

On the single-file upload page, press the "Upload file" button to upload the file. This might take some time if you're uploading a large file over a slow internet connection.

Duplicate files

If you upload a file with the single-file upload page with the same name as an existing one, or if MediaWiki detects that a file is the same as an already uploaded file, it warns you of the situation after you upload the file, but before any changes are made. You can replace an existing file if your version is newer; consult the file history on the file page to see when the image was uploaded, and if you're unsure, ask about replacing the file on the file page's talk page.

The batch upload page does not inform you of duplicate files. If you upload a file that already exists with the batch file uploader, MediaWiki adds the duplicate as a new version.

File categories

The {{File}} template handles many of the common categories for files. Fill every template parameter that you can in order to make the file more accessible through searches and category listings.

Notable keyword categories

When uploading images, consider using some of these useful keywords (like keyword1 mentioned above):

For images depicting a character's full form, similar to the artwork you might see on a pawn, use full-body portraits. For images depicting a character's face or bust, similar to the artwork you might see on a face card, use face portraits.
Races and creature types
If an image is the only image you can find on the wiki for a creature, note its type, such as humanoids or outsiders. If it's one of multiple images of the creature, simply use the creature's plural form, like humans or goblins.
Example: File:Red serpentfolk.jpg
If the image is one of multiple images on the wiki depicting a person or named creature, add their name, such as Seoni or Asmodeus.
(character classes)
If the image is of a character with classes, you can add them as keywords, such as wizards and experts.
Example: File:Valeros.jpg
landscapes and city landscapes
If an image depicts a landscape, add the landscapes keyword. If it's a landscape of a city, add the city landscapes keyword as well as the name of the city, such as Korvosa.
Example: File:Korvosa panorama.jpg
Several keywords are useful for logos and symbols, including logos for real-world logos, holy symbols for divine symbols, and national symbols and city symbols for flags, crests, banners, and other municipal symbols.
Example: File:Korvosan Flag.jpg

Using uploaded files

You can embed images into articles using the regular internal link syntax:



Images can also be resized to fit better on the page by providing a width in pixels:



Images can be framed by using the thumb parameter:


... and aligned to the left or right of the page with text wrapping around it:


... and captioned with wikitext:

[[File:Wiki.png|60px|thumb|right|The [[PathfinderWiki]] logo.]]

You can also link the image itself to a specific page. By default, it links to its file description page:

The PathfinderWiki logo.
[[File:Wiki.png|60px|thumb|right|The [[PathfinderWiki]] logo.|link=PathfinderWiki]]

To link to a file in text instead of displaying it, prefix the file page reference with a colon:

[[:File:Wiki.png|Click here for an image of the PathfinderWiki logo.]]

Click here for an image of the PathfinderWiki logo.

If you uploaded an audio file, you can use the {{Audioplayer}} template to provide a compact interface for readers to listen to the audio:

{{Audioplayer|name=Hook Mountain trailer.mp3}}