# Maximum Upload Size Settings

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

* [Using IIS](#using-iis)
* [Hosting on Umbraco Cloud](#hosting-on-umbraco-cloud)
* [Using Kestrel](#using-kestrel)

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

{% hint style="info" %}
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.
{% endhint %}

## 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
<?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:

```json
"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":

<figure><img src="/files/i4Su3qwaFRW6QIxpG9LU" alt="System Information with Maximum Upload Size Settings"><figcaption></figcaption></figure>

## External Server Configurations

### [Using Nginx (external)](https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size)

### [Using apache (external)](https://httpd.apache.org/docs/2.2/mod/core.html#limitrequestbody)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-cms/reference/configuration/maximumuploadsizesettings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.