MediaWiki extensions manual
Release status: stable
Implementation Data extraction, Variable
Description Automatically add new uploads to categories based on file metadata
Author(s) Ryan Schmidt (Skizzerztalk)
Latest version 2.0.1 (2020-05-08)
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.31+
License GNU General Public License 3.0
Download Download latest version
Quarterly downloads 3 (Ranked 134th)
Translate the AutoCategoriseUploads extension if it is available at translatewiki.net

This extension automatically adds categories to new file uploads based on keyword metadata found in the file. The following metadata types are supported:

  • XMP (many file types, including JPG, PNG, PDF, etc.)
  • ITCP (JPG)
  • ID3 (MP3)
  • And more!

A new magic word {{FILECATEGORIES}} is added by this extension. Adding this magic word to a file description page will automatically pull categories out of the file metadata and place the description page into those categories. This magic word will be automatically inserted into the page text of newly-uploaded files, but it will need to be manually added to existing files.


  • Download and place the file(s) in a directory called AutoCategoriseUploads in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'AutoCategoriseUploads' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.



Extension support is handled via the MediaWiki Users forum. Requests on the talk page here are likely to be overlooked. Commercial support plans are available for purchase.