From MediaWiki.org
Jump to: navigation, search

Other languages:
العربية • ‎বাংলা • ‎català • ‎Deutsch • ‎English • ‎español • ‎suomi • ‎français • ‎italiano • ‎日本語 • ‎मराठी • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎sicilianu • ‎中文
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png

Release status:Extension status unmaintained

MultiUpload Screenshot - Ghost.png
ImplementationTemplate:Extension#type Special page
DescriptionTemplate:Extension#description Allows users to upload more than one file at a time
Author(s)Template:Extension#username Lee Worden (originally by Travis Derouin)
Latest versionTemplate:Extension#version 3.0 (2014-04-09)
MediaWikiTemplate:Extension#mediawiki 1.19-1.25
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
  • $wgMultiUploadInitialNumberOfImportRows
  • $wgMultiUploadTempDir

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

Check usage and version matrix.


Open tasks · Report a bug

The MultiUpload extension allows users to upload more than one file at a time. It also unpacks package files (.zip, .tar, .tar.gz, and .tgz), allowing the files found in the package to be uploaded to the wiki.


  • Download and place the file(s) in a directory called MultiUpload in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/MultiUpload/MultiUpload.php";
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
For this extension to work, you have to have already allowed uploads on your wiki, see Manual:Configuring file uploads.


Creating links to the extension[edit]

In the sidebar[edit]

To add a link to the sidebar by editing MediaWiki:Sidebar, adding a new line:

** Special:Multiupload|multiupload ("upload files")


** Special:Multiupload|multiupload-toolbox ("Upload multiple files").
In both examples of adding links to this extension in MediaWiki:Sidebar, if only "multipleupload" or "multipleupload-toolbox" shows in the sidebar, you may have to navigate in your wiki to "MediaWiki:Multipleupload" or "MediaWiki:Multipleupload-toolbox" and create the pages with the messages that are already shown.

Replacing 'Upload file' with MultiUpload in the sidebar[edit]

In the LocalSettings.php file, right below the last require_once line add:

$wgUploadNavigationUrl = "{$wgScriptPath}/index.php?title=Special:MultiUpload";

Setting the maximum number of files to upload[edit]

Warning Warning: As of r115614, the $wgMaxUploadFiles global isn't respected. After that commit, members of the staff group could upload 40 files at once via Special:MultiUpload, whereas sysop group could upload 20 at once, autoconfirmed could upload 10 and all other registered users could upload 5 files at once. Now, after complete replacement of the source code, it begins with one file and adds more as files are selected, with no upper limit.

To set the number of files to upload at once, Configure $wgMaxUploadFiles in your local settings file, the default setting is 5. The $wgMaxUploadFiles statement must be made after the require_once call. For example:

$wgMaxUploadFiles = 10;


Warning Warning: These messages and their names have changed since April 9, 2014, when the extension was rewritten. Notably, the message displayed on the top of the special page is now called Multiupload-text, no longer Multipleupload-text. Some of the older extension messages no longer exist.

You can change the messages of this extension through pages of MediaWiki namespace starting with multipleupload. For example, [[MediaWiki:Multiupload-text]] is the message displayed on MultipleUpload special page.

Other messages are:

  • multiupload-submit
  • multiupload-uploadedto
  • multiupload-row-name-base
  • multiupload-unpack-button
  • multiupload-notify-ok
  • multiupload-upload-package-error
  • multiupload-unpack-error
  • multiupload-http-error
  • multiupload-file-unpacked-from

See also[edit]