Update upgrade guide for changes regarding updateing metadata in tran…

…sactionUpdate
saleor · Jan 15, 2025 · 5f552d4 · 5f552d4
1 parent a0dfb63
commit 5f552d4
Showing 1 changed file with 6 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
@@ -14,6 +14,12 @@ The [updateMetadata](/api-reference/miscellaneous/mutations/update-metadata.mdx)
 Once an order is created, customers cannot edit its metadata. However, merchants and apps with the necessary permissions can modify this data.
 Fetching metadata remains unchanged.
 
+## Merging metadata in `transactionUpdate` mutation
+
+The [transactionUpdate](/api-reference/payments/mutations/transaction-update.mdx) mutation now merges the provided metadata and private metadata with existing values, instead of overwriting them.
+To delete a specific metadata entry, use the [deleteMetadata](/api-reference/miscellaneous/mutations/delete-metadata.mdx) mutation.
+For private metadata, use the [deletePrivateMetadata](/api-reference/miscellaneous/mutations/delete-private-metadata.mdx) mutation.
+
 ## Deprecated `manager.perform_mutation` method
 
 Note: This change only affects open-source Saleor users with custom plugins overriding the `perform_mutation` plugin method.