From 2eb490755f96f8f832cdb3eecbbe8eba26e9871b Mon Sep 17 00:00:00 2001
From: Jacob Overgaard <752371+iOvergaard@users.noreply.github.com>
Date: Thu, 14 Aug 2025 13:19:55 +0200
Subject: [PATCH 1/2] docs: adds a hint box and information to advise
 developers to set MaxRequestLength as the Backoffice uses that value

---
 .../reference/configuration/maximumuploadsizesettings.md      | 4 ++++
 16/umbraco-cms/reference/configuration/runtimesettings.md     | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/16/umbraco-cms/reference/configuration/maximumuploadsizesettings.md b/16/umbraco-cms/reference/configuration/maximumuploadsizesettings.md
index dfdb5c6c769..8eebdfd6448 100644
--- a/16/umbraco-cms/reference/configuration/maximumuploadsizesettings.md
+++ b/16/umbraco-cms/reference/configuration/maximumuploadsizesettings.md
@@ -12,6 +12,10 @@ Learn how to change the upload size limit for your Umbraco site depending on you
 
 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.
diff --git a/16/umbraco-cms/reference/configuration/runtimesettings.md b/16/umbraco-cms/reference/configuration/runtimesettings.md
index ac24b9bc7fe..3798857f7ab 100644
--- a/16/umbraco-cms/reference/configuration/runtimesettings.md
+++ b/16/umbraco-cms/reference/configuration/runtimesettings.md
@@ -24,7 +24,7 @@ An example of a configuration could look something like:
 }
 ```
 
-- `MaxRequestLength` is specified in kilobytes. Setting this limits the request size, including the size of uploaded files. This only has an effect when hosting with Kestrel. See the [Maximum Upload Size Settings
+- `MaxRequestLength` is specified in kilobytes. Setting this limits the request size, including the size of uploaded files. This only has an effect on the server when hosting with Kestrel. But it is also used by the Backoffice to advise the users. See the [Maximum Upload Size Settings
 ](./maximumuploadsizesettings.md) article for more information.
 - `Mode` can have three values: `BackofficeDevelopment` (default), `Development`, and `Production`. For more information, see the [Runtime modes](../../fundamentals/setup/server-setup/runtime-modes.md) article.
 - `TemporaryFileLifeTime` is specified as a timespan. The default value is one day - `1.00:00:00`.

From ad8f9261b8ae3e4b37f58bf965679b53c0c1d1f7 Mon Sep 17 00:00:00 2001
From: Jacob Overgaard <752371+iOvergaard@users.noreply.github.com>
Date: Thu, 14 Aug 2025 13:22:34 +0200
Subject: [PATCH 2/2] docs: formatting

---
 16/umbraco-cms/reference/configuration/runtimesettings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/16/umbraco-cms/reference/configuration/runtimesettings.md b/16/umbraco-cms/reference/configuration/runtimesettings.md
index 3798857f7ab..91d7eb2d412 100644
--- a/16/umbraco-cms/reference/configuration/runtimesettings.md
+++ b/16/umbraco-cms/reference/configuration/runtimesettings.md
@@ -24,7 +24,7 @@ An example of a configuration could look something like:
 }
 ```
 
-- `MaxRequestLength` is specified in kilobytes. Setting this limits the request size, including the size of uploaded files. This only has an effect on the server when hosting with Kestrel. But it is also used by the Backoffice to advise the users. See the [Maximum Upload Size Settings
+- `MaxRequestLength` is specified in kilobytes. Setting this limits the request size, including the size of uploaded files. This only has an effect on the server when hosting with Kestrel, but is also used by the Backoffice to advise users. See the [Maximum Upload Size Settings
 ](./maximumuploadsizesettings.md) article for more information.
 - `Mode` can have three values: `BackofficeDevelopment` (default), `Development`, and `Production`. For more information, see the [Runtime modes](../../fundamentals/setup/server-setup/runtime-modes.md) article.
 - `TemporaryFileLifeTime` is specified as a timespan. The default value is one day - `1.00:00:00`.