Added documentation for managing DOTNET_ENVIRONMENT

umbraco-cloud/getting-started/environments.md

@@ -59,6 +59,8 @@ It is possible to set up specific configurations for each environment:
 
 The `EnvironmentAlias` is fetched from the Environment variable named `DOTNET_ENVIRONMENT`. This variable can be found in the Environment Variables section of Kudu on the environment. You can read more about ASP.NET Configuration in the official [Microsoft documentation](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-9.0).
 
+The value of the `DOTNET_ENVIRONMENT` environment variable can be managed through the **Advanced** settings in the **Configuration** section of the Cloud Portal.
+
 {% hint style="info" %}
 Make sure that when you start up the Umbraco Application, you load the correct JSON file as per the ASP.NET Configuration in the official [Microsoft documentation](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-9.0).
 {% endhint %}

umbraco-cloud/release-notes/overview-2025/2025-06-releasenotes.md

@@ -4,6 +4,7 @@
 * **Hostname Monitoring** – Get notified when your hostnames do not behave as expected, directly from the Cloud Portal.
 * **CI/CD v2 with target environment support** – You can now specify a development or flexible environment by name when deploying from pipelines.
 * **Umbraco version 16** –  Umbraco version 16 is now available on Umbraco Cloud.
+* **Managing `DOTNET_ENVIRONMENT` environment variable** - You can now view and edit the `DOTNET_ENVIRONMENT` environment variable on Cloud Portal.
 
 ## Hostname Monitoring
 Hostname Monitoring is now available on Umbraco Cloud, giving you better visibility and control over your environment setup.
@@ -18,7 +19,12 @@ Currently, target environments must be either the default development environmen
 
 Learn more in the [CI/CD on Umbraco Cloud](https://docs.umbraco.com/umbraco-cloud/set-up/project-settings/umbraco-cicd) article.
 
-## Umbraco version  16
+## Umbraco version 16
 You can now start new projects on Umbraco 16 or upgrade your existing projects to take advantage of the latest features and improvements.
 
 Umbraco version 16 still runs on .NET 9, like Umbraco version 15.
+
+## Managing `DOTNET_ENVIRONMENT` environment variable
+It is now possible to view and edit the `DOTNET_ENVIRONMENT` variable on Cloud Portal. This can be done by navigating to the **Advanced** settings in the **Configuration** section.
+
+This feature gives you more control over the configuration of your Umbraco Cloud environment. By specifying a custom `DOTNET_ENVIRONMENT` value, you can load different environment-specific settings per environment.

umbraco-cloud/release-notes/overview-2025/overview-2025.md

@@ -8,6 +8,7 @@ description: Get an overview of the release notes for each month in 2025.
 * **Hostname Monitoring** – Get notified when your hostnames do not behave as expected, directly from the Cloud Portal.
 * **CI/CD v2 with target environment support** – You can now specify a development or flexible environment by name when deploying from pipelines.
 * **Umbraco version 16** –  Umbraco version 16 is now available on Umbraco Cloud.
+* **Managing `DOTNET_ENVIRONMENT` environment variable** - You can now view and edit the `DOTNET_ENVIRONMENT` environment variable on Cloud Portal.
 
 ## [May 2025](2025-05-releasenotes.md)
 

umbraco-cloud/set-up/project-settings/README.md

@@ -122,13 +122,20 @@ The Advanced section provides options for managing advanced settings for your pr
 * Enable IIS logging for each environment. The log files can be accessed in Kudu at `C:\home\LogFiles\http`. IIS logs have a rolling size limit of 100 MB, overwriting the oldest files once the limit is reached.
 * [Enable loading of a client certificate from the file system](application-settings.md#enable-client-certificate-loaded-from-file-system-explained).
 * Change the .NET framework runtime for each environment of your Umbraco Cloud project.
+* Change the value of the `DOTNET_ENVIRONMENT` environment variable for each environment of your Umbraco Cloud project. To learn more about working with multiple environments in ASP.NET Core, refer to the [Microsoft Documentation](https://learn.microsoft.com/en-us/aspnet/core/fundamentals/environments?view=aspnetcore-9.0).
 
 {% hint style="info" %}
 Enabling IIS logging will cause the site to restart. For additional information, refer to the [Microsoft Documentation](https://docs.microsoft.com/en-us/iis/configuration/system.webserver/httplogging).
 {% endhint %}
 
+{% hint style="info" %}
+Changing the .NET framework runtime or the `DOTNET_ENVIRONMENT` environment variable will also cause your website to restart.
+{% endhint %}
+
 ![Advanced Settings](../images/advanced-settings.png)
 
+![Advanced Settings continued](../images/advanced-settings-continued.png)
+
 ### [Backups](../../databases/backups.md#backup-on-umbraco-cloud)
 
 The Backups section enables you to create database backups for one or more of your cloud environments.