From 6569069018cc710a66873e1c31e1f7c4e82e78a9 Mon Sep 17 00:00:00 2001 From: Sanaya Vaze Date: Wed, 12 Aug 2026 11:07:27 +0530 Subject: [PATCH 1/2] Add doc details for name matching --- .../app-explorer/modules/updating-marketplace-modules.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md b/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md index 7554dbdf920..9f3873bb59d 100644 --- a/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md +++ b/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md @@ -35,6 +35,8 @@ To merge your customizations with the updated module, Studio Pro matches documen * Modules with package IDs – Studio Pro uses embedded GUID mapping to match documents by GUID. This is more reliable because documents can be matched even if they have been renamed. +* Modules without package IDs – Studio Pro attempts to map documents by name. This works well as long as document names have not changed between versions. + {{% alert color="info" %}} Studio Pro 11.12 introduced package IDs and document GUID mappings to make updates more reliable. {{% /alert %}} From 6b172c4d1d4f4acf23a45f4a41b4aefb9bb31c78 Mon Sep 17 00:00:00 2001 From: Sanaya Vaze Date: Wed, 12 Aug 2026 11:34:06 +0530 Subject: [PATCH 2/2] Add more changes --- .../refguide/modeling/app-explorer/modules/module-settings.md | 2 ++ .../app-explorer/modules/updating-marketplace-modules.md | 4 ++++ 2 files changed, 6 insertions(+) diff --git a/content/en/docs/refguide/modeling/app-explorer/modules/module-settings.md b/content/en/docs/refguide/modeling/app-explorer/modules/module-settings.md index 70274c2bfb3..b64727736c0 100644 --- a/content/en/docs/refguide/modeling/app-explorer/modules/module-settings.md +++ b/content/en/docs/refguide/modeling/app-explorer/modules/module-settings.md @@ -96,6 +96,8 @@ Improved package management is available for [Studio Pro 11.12](/releasenotes/st Studio Pro 11.12 introduces improved package management to enable reliable module tracking and updates. +For more information on how to use package management when updating modules, see [Updating Marketplace Modules](https://github.com/mendix/docs/blob/development/refguide/updating-marketplace-modules). + Key improvements are delivered through new module properties and a new `manifest.json` file format in module packages (*.mpk* files): * **Package identification** – Each module receives a [Module ID](#module-id) that uniquely identifies it across all versions. This allows Studio Pro to reliably track modules across updates, even if the module name changes. diff --git a/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md b/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md index 9f3873bb59d..93832cdc8f1 100644 --- a/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md +++ b/content/en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md @@ -15,6 +15,10 @@ Previously, when you wanted to update a Marketplace module to a newer version, y Studio Pro 11.12 changes this by enabling module updates that retain your customizations. When you update a module, Studio Pro performs a three-way merge that combines your customizations with the publisher's updates. You can keep your changes and benefit from bug fixes and new features in the updated module. +{{% alert color="info" %}} +Studio Pro 11.12 introduces improved package management with package IDs and document GUID mappings that make updates more reliable. However, updates with customization retention also work for older modules without package IDs through name-based mapping. For more information on package management, see Module Settings. +{{% /alert %}} + ## How Module Updates Work ### Three-Way Merge Process