diff --git a/docs/sources/upgrading/_index.md b/docs/sources/upgrading/_index.md
index 4b012c2b7b..f8408c6914 100644
--- a/docs/sources/upgrading/_index.md
+++ b/docs/sources/upgrading/_index.md
@@ -31,6 +31,13 @@ The output is incredibly verbose as it shows the entire internal config struct u
 
 ## Main / Unreleased
 
+
+### Loki
+
+#### Default value for `azure.container-name` changed
+
+This value now defaults to `loki`, it was previously set to `cortex`. If you are relying on this container name for your chunks or ruler storage, you will have to manually specify `-azure.container-name=cortex` or `-ruler.storage.azure.container-name=cortex` respectively.
+
 ## 2.5.0
 
 ### Loki