This script/stylesheet is for PERSONAL use only!
You are free to install this script/stylesheet for yourself, but it is not allowed to be used wiki-wide (e.g., in MediaWiki:ImportJS, MediaWiki:Common.js, MediaWiki:Common.css, MediaWiki:Fandomdesktop.js, MediaWiki:Fandomdesktop.css, or MediaWiki:FandomMobile.css), as it would violate Fandom's Terms of Use.
(See the customization policy)
MultiUpload is a script that allows you to select multiple files directly from the open dialog box on Special:Upload. You can also change their upload file names, descriptions and licences.
Installation
Configuration
All of MultiUpload configuration goes into the variable window.dev.multiupload.options.
To avoid spam and image flood, the number of files that can be uploaded at a time is limited to user rights:
- User: 20
- Rollback and content-moderator: 30
- Sysop/admin: 50
- Bureaucrat and bot: 70
- Staff, util, global bot, and wiki-specialist: 200
This limit can be edited with the options (see the table below).
Available options
| Option | Type | What it changes |
|---|---|---|
max
|
Number | The maximum number of files to upload at a time. Note that the value is capped at 100. If you set it beyond 100, it will revert to your user right limit. |
defaultlicense
|
String | The default license to be selected in every license drop-down menu. To know which value to put, go to your localized MediaWiki:Licenses on your wiki (eg. MediaWiki:Licenses/fr for French). Then, put the text before the | of the license by default you want. }}}
|
defaultdescription
|
String | The default description displayed in every description textarea. This is mainly useful to add a default template by default or one or more Categories to many files at once. |
Example
It is possible to mix multiple configurations in one assignment. Here is an example:
// Instantiate the configuration object
window.dev = window.dev || {};
window.dev.multiupload = window.dev.multiupload || {};
// We are setting the limit to 50 and the default license to Public Domain
window.dev.multiupload.options = {
max: 50,
defaultlicense: 'PD'
};
Using configuration options with Fandom Developers Wiki scripts
The instructions on this page describe how to use configuration options with a script. Here on the Fandom Developers Wiki, many scripts provide optional configuration settings as a mean to alter or enhance the default behavior of the script. When installing configuration options in your JavaScript file, please note that they need to go above the import statement in order to work — unless the directions say otherwise. In case MediaWiki:ImportJS is used to load the scripts, it will be executed last.
// 1. AjaxRC import statement
importArticles({
type: 'script',
articles: [
'u:dev:MediaWiki:AjaxRC.js'
]
});
// 2. AjaxRC configuration option
window.ajaxRefresh = 30000;
// 1. AjaxRC configuration option
window.ajaxRefresh = 30000;
// 2. AjaxRC import statement
importArticles({
type: 'script',
articles: [
'u:dev:MediaWiki:AjaxRC.js'
]
});
Migrate legacy options
Previously, MultiUpload options were kept in the window.MultiUploadoption variable. However, to have all MultiUpload variables under the same window property, it was decided to move them to window.dev.multiupload. There is a mechanism ensuring retrocompatibility, but it will be removed in the future.
To migrate just edit your configuration as follows:
// Change this
window.MultiUploadoption = {...};
// Into this
window.dev = window.dev || {};
window.dev.multiupload = window.dev.multiupload || {};
window.dev.multiupload.options = {...};
Known issues
All URL encoded are not permitted for example, in textbox, Image-picture.png will fail but Image picture.png will work.
Changelog
- September 16, 2025 (Fujimaru-kun)
- Add missing warning messages.
- Move configuration options under window.dev.multiupload.options.
- Fix form reset.
- November 26, 2024 (NoWayThisUsernameIsAlreadyOwnedBySomeone)
- Fix and significantly improve displayed error/warning messages.
- No longer activate the script when Special:Upload was opened through a redlink (you only want to upload that specific file in that case).
- Fix that browsers would ask for confirmation before leaving the upload page even if all uploads had already completed.
- Add a progress bar and more visible completion notifications.
- July 2, 2024 (Chomchaum)
- Add a default description option
- June 14, 2021 (Fujimaru-kun)
- Add a default license option
- November 2020 (Fujimaru-kun)
- UCP-compatible version
- June 16, 2019 (KhangND)
- Rewrite, major improvements: Fixed asynchronous state, improved notification, added reset button...
- January 1, 2015 (Gguigui1)
- Script published
See also
- UploadMultipleFiles - Similar to MultiUpload but allows selection of multiple files directly from a single dialog box.
- Wiki-Up - Similar functionality written in C#.
