From 5f552d4d084b5c1bc7ea413166e60cba9b4ecf62 Mon Sep 17 00:00:00 2001 From: IKarbowiak Date: Wed, 15 Jan 2025 12:11:41 +0100 Subject: [PATCH] Update upgrade guide for changes regarding updateing metadata in transactionUpdate --- docs/upgrade-guides/core/3-20-to-3-21.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/upgrade-guides/core/3-20-to-3-21.mdx b/docs/upgrade-guides/core/3-20-to-3-21.mdx index 99c920d27..9686bff5b 100644 --- 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.