Maximum Upload Size Settings

Information on how to change the default cap of upload size

Learn how to change the upload size limit for your Umbraco site depending on your hosting setup:

• Using IIS
• Hosting on Umbraco Cloud
• Using Kestrel

By default, Umbraco does not restrict upload size. The limits are controlled by the hosting platform.

It is advisable that you tell Umbraco what the maximum upload size is by setting the Umbraco:CMS:Runtime:MaxRequestLength in the appsettings.json file. The Backoffice will use this value to help guide the users.

Using IIS

The default upload limit in IIS is 30000000 bytes (~28.6 MB). The maximum value allowed is 4 GB.

To increase the upload limit:

1. Create or update the web.config file at the root of your project.
2. Add the following configuration:

<?xml version="1.0"?>
<configuration>
  <system.webServer>
    <security>
      <requestFiltering>
        <!-- 2 MB in bytes -->
        <requestLimits maxAllowedContentLength="2000000" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

maxAllowedContentLength is specified in bytes. For example:

• 2 MB = 2097152 bytes
• 100 MB = 104857600 bytes
• 500 MB = 524288000 bytes
• 4 GB = 4294967295 (maximum value allowed)

Hosting on Umbraco Cloud

Umbraco Cloud uses IIS for hosting, so you must apply this setting in your web.config file. The maximum permitted upload size on Umbraco Cloud is 500 MB.

To change the limit, update the maxAllowedContentLength value in your web.config file accordingly.

Using Kestrel

Kestrel’s runtime settings allow you to configure MaxRequestLength. If you want to upload files larger than 50MB, or amend this default, update this value in the appsettings.json file.

Example configuration:

"Umbraco": {
  "CMS": {
    "Runtime": {
      "MaxRequestLength": 2000
    }
  }
}

• MaxRequestLength is specified in kilobytes. For example:

  • 2000 KB = 2 MB
  • 100000 KB = 100 MB

You can check the current configuration by inspecting the "System information" output in the Backoffice. You can access it by clicking the logo and then "System information":

External Server Configurations

Using Nginx (external)

Using apache (external)