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:

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

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 = 2,000,000 bytes

  • 100 MB = 100,000,000 bytes

  • 4 GB = 4294967295 (maximum value allowed)

Hosting on Umbraco Cloud

Umbraco Cloud uses IIS for hosting, so changes must be made in the web.config file as described above. The default upload limit on Umbraco Cloud is 500 MB.

To customize this limit, adjust the maxAllowedContentLength value in your web.config file accordingly.

Using Kestrel

Kestrel’s runtime settings allow you to configure MaxRequestLength and MaxQueryStringLength. If you want to upload files larger than 28.6MB, update these values in the appsettings.json file.

Example configuration:

"Umbraco": {
  "CMS": {
    "Runtime": {
      "MaxQueryStringLength": 90,
      "MaxRequestLength": 2000
    }
  }
}
  • MaxRequestLength is specified in kilobytes. For example:

    • 2000 KB = 2 MB

    • 100000 KB = 100 MB

  • MaxQueryStringLength sets the maximum number of characters in the query string.

External Server Configurations

Last updated

Was this helpful?