MediaWiki extensions manual
Release status: stable
Implementation User interface
Description Enables users to easily import files (including histories) to a wiki
Author(s) Wikimedia Germany (WMDE)
Latest version continuous updates
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki >= 1.41.0
License GNU General Public License 2.0 or later
Help Help:Extension:FileImporter
  • $wgFileImporterRequiredRight
  • $wgFileImporterSourceSiteServices
  • $wgFileImporterSourceWikiTemplating
  • $wgFileImporterCommonsHelperHelpPage
  • $wgFileImporterCommonsHelperServer
  • $wgFileImporterWikidataEntityEndpoint
  • $wgFileImporterMaxRevisions
  • $wgFileImporterAccountForSuppressedUsername
  • $wgFileImporterInterWikiMap
  • $wgFileImporterMaxAggregatedBytes
  • $wgFileImporterCommonsHelperBasePageName
  • $wgFileImporterCommentForPostImportRevision
  • $wgFileImporterShowInputScreen
  • $wgFileImporterSourceWikiDeletion
  • $wgFileImporterTextForPostImportRevision
  • $wgFileImporterWikidataNowCommonsEntity
Quarterly downloads 33 (Ranked 143rd)
Translate the FileImporter extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The FileImporter extension provides a simple interface accepting a single URL which can be used to import files to a wiki.


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


A detailed documentation of the workflow and the configuration of the extension can be found in the README.md file inside the source repository. Additionally to that there is a list of metrics data recorded to further inspect occurring problems and the usage of the extension in metrics.md.