Update upgrade guide for required authentication for changing order m…

…etadata
saleor · Jan 8, 2025 · 207276a · 207276a
1 parent 685d481
commit 207276a
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/upgrade-guides/core/3-20-to-3-21.mdx b/docs/upgrade-guides/core/3-20-to-3-21.mdx
@@ -8,6 +8,11 @@ To follow the zero-downtime strategy when upgrading to 3.21, **It is recommended
 Otherwise, you will need to downtime your solution to ensure correct data migration.
 :::
 
+## Authentication required for changing `Order` and `OrderLine` metadata
+
+The [updateMetadata](/api-reference/miscellaneous/mutations/update-metadata.mdx) mutation for `Order` and `OrderLine` now requires the `MANAGE_ORDERS` permission.
+After an order is created, customers cannot edit its metadata. Merchants, however, can modify this data using an app built with the appropriate permission.
+
 ## Deprecated `manager.perform_mutation` method
 
 Note: This change only affects open-source Saleor users with custom plugins overriding the `perform_mutation` plugin method.