From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg

Release status:Extension status stable

ImplementationTemplate:Extension#type Data extraction
DescriptionTemplate:Extension#description Automatically add new uploads to categories based on file metadata
Author(s)Template:Extension#username Ryan Schmidt (Skizzerztalk)
Latest versionTemplate:Extension#version 1.0.0 (2018-04-03)
Compatibility policyCompatibility#mediawiki_extensions master
MediaWikiTemplate:Extension#mediawiki 1.30+
LicenseTemplate:Extension#license GNU General Public License 3.0
Download Download latest version
Hooks usedTemplate:Extension#hook

Translate the AutoCategoriseUploads extension if it is available at translatewiki.net

Check usage and version matrix.

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)

Categories are added to new uploads only (that is, uploads where a file description page does not already exist). This lets editors modify the categories without needing to worry about new versions of the file overwriting their changes. Any form of uploading is supported, whether that is via Special:Upload, the UploadWizard extension, uploading files via the API, or maintenance scripts to bulk-upload 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:
    wfLoadExtension( 'AutoCategoriseUploads' );
  • YesY 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.