← UMM 2027 Materials Academy ↗

Documentation / Inspection & cleanup

Merge Duplicates

Consolidate eligible duplicate materials while respecting protected references.

Where to find it
Main toolbar → Merge Duplicates
Scope
Model material references
What changes
Reassigns eligible duplicates and removes removable definitions.
On this page

How to use it

  1. Choose Merge Duplicates.
  2. Review the result for merged materials and materials retained because of protected or locked references.

Expected result

Consolidate eligible repeated finishes from imported furniture while retaining materials required by saved alternatives.

Controls & options

Merge Duplicates controls and behavior
ControlWhat it does
Merge DuplicatesDetect and review the duplicate merge operation.
ResultRead which materials were merged or retained. Protected and locked references can prevent removal.

Saved variant protection

Imagine Natural Oak is applied while Dark Timber is saved as an alternative. The dark material may have no current model assignments, but the saved look still needs it. UMM reads saved variant references when deciding what cleanup may remove.

Protection covers references in saved sets and supported saved mapping data. It is not limited to the currently selected or applied variant.

Merge behavior and retained materials

UMM excludes variant-protected materials from duplicate replacements that would remove them. Two similar-looking materials may intentionally remain because a saved look or mapping refers to a particular material.

Merge Duplicates still handles eligible unprotected duplicates. A material with locked references can also be retained; the result explains what could not be removed.