View source for Manual:$wgMaxUploadSize

<languages/>
{{SettingSummary
|name=MaxUploadSize
|version_min=1.8.0
|rev_introduced=16159
|section=Uploads
|range=(<translate><!--T:1--> integer or array</translate>) (<translate><!--T:2--> see below</translate>)
|default=1024*1024*100 (100MB)
|summary=<translate><!--T:3--> Maximum size of uploaded files (in bytes)</translate>
}}
<translate>
== Details == <!--T:4-->

<!--T:5-->
This setting allows you to place a maximum size on each file that can be uploaded to your wiki.
</translate>

<translate><!--T:6--> The value(s) you specify refer to the maximum size, in bytes, of a single file upload (not the total of all uploaded files).</translate>
<translate><!--T:7--> The limit is applied at the time of upload, so lowering this value at a later date won't remove existing files that are now 'too large'.</translate>
<translate><!--T:8--> This limit only applies to [[<tvar name=1>Special:MyLanguage/API:Upload#Chunked uploading</tvar>|chunked uploads]] and uploads without separate chunks might have a lower upload limit based on the PHP setting.</translate>

<translate>
<!--T:9-->
There are 1024 bytes in a kilobyte, and 1024 kilobytes in a megabyte, so <code>1024 * 1024 * 100</code> = 100 megabytes.
</translate>

{{Note|1='''<translate><!--T:10--> The limits for file uploads are controlled by PHP configuration directives.</translate>''' <translate><!--T:11--> To change the limits for file uploads, you need to modify '''php.ini''', see <tvar name=1>[https://php.net/ini.core#ini.upload-max-filesize upload_max_filesize]</tvar> and <tvar name=2>[https://php.net/ini.core#ini.post-max-size post_max_size]</tvar> PHP configuration options as well as [[<tvar name=man>Special:MyLanguage/Manual:Configuring file uploads#Set maximum size for file uploads</tvar>|Manual:Configuring file uploads]] for details.</translate> <translate><!--T:12--> Note that whichever one of these php.ini variables is smallest will be the limiter. By default, PHP does not allow uploaded files to be more than 2 megabytes.</translate>}}

<translate>
=== Specifying an integer === <!--T:13-->

<!--T:14-->
This limits the maximum size of uploaded files, in bytes, regardless of how they are uploaded.
</translate>

<syntaxhighlight lang="php">
$wgMaxUploadSize = 20000000;
</syntaxhighlight>

<translate>
=== Specifying an array === <!--T:15-->
</translate>
<translate><!--T:16--> If you would like different maximum sizes for file uploads and upload-by-URL, you can set this variable to an array.</translate>
<translate><!--T:17--> For example:</translate>

<syntaxhighlight lang=php>
$wgMaxUploadSize = [
    '*' => 250 * 1024, // 250 KB
    'url' => 500 * 1024, // 500 KB
];
</syntaxhighlight>

<translate>
<!--T:18-->
This example will set the maximum for all uploads to 250 KB, except for upload-by-URL, which will have a maximum of 500 KB.

<!--T:19-->
To enable upload-by-URL, see <tvar name=1>{{wg|AllowCopyUploads}}</tvar>.
</translate>

{{MW 1.17|and before}}
{{Note|1='''<translate><!--T:20--> This option has no effect on the normal upload feature for MediaWiki 1.17 and lower!</translate>''' <translate><!--T:21--> If you've enabled <tvar name=AllowCopyUploads>{{ll|Manual:$wgAllowCopyUploads|$wgAllowCopyUploads}}</tvar>, this setting does limit the size of files copied from a remote URL as expected.</translate> <translate><!--T:22--> When uploading files from your local machine, this setting has '''no effect''' (for at least versions 1.9.3 through 1.12).</translate>}}

<translate>
== See also == <!--T:23-->
</translate>
* {{ll|Manual:$wgUploadSizeWarning|$wgUploadSizeWarning}}