Skip to content

Name matching documentation #11711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sanaya-m wants to merge 2 commits into
base: development
Choose a base branch
from
+8 −0
Open

Name matching documentation #11711

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6569069
Add doc details for name matching
sanaya-m Aug 12, 2026
6b172c4
Add more changes
sanaya-m Aug 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions content/en/docs/refguide/modeling/app-explorer/modules/module-settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
6 changes: 6 additions & 0 deletions .../en/docs/refguide/modeling/app-explorer/modules/updating-marketplace-modules.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -35,6 +39,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 %}}
Expand Down