> For the complete documentation index, see [llms.txt](https://docs.colormass.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.colormass.com/building-blocks/materials/change-a-map-substrate.md).

# Change a Map (Substrate)

In some cases, it’s necessary to replace a map of a scanned or finished material. Most often, this involves swapping the diffuse map to introduce a new pattern while preserving the other captured reflection details.

{% hint style="warning" %}
Please note that this is an advanced change. If you are not sure what this option does, we recommend not using it.
{% endhint %}

The best way to start is by copying an existing material, such as a substrate scan (see [Copy a Material](/building-blocks/materials/copy-a-material.md)). Once you open the copied material, you will see the original set of textures displayed.

Next you would need to add a new Texture Set:

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FisMNgM7AxuHSST4t876k%2Fnew%20texturset.png?alt=media&amp;token=bfb65923-2a0a-4d1a-9760-f144b7670148" alt=""><figcaption></figcaption></figure>

Inside the new Texture Set, upload your new map (in this case, the Diffuse Map) by simply dragging and dropping it, as shown below:

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FuUlIm5rYByoPvmzbyRR4%2FScreenshot%202026-05-15%20114449.png?alt=media&amp;token=9a1b234b-597f-4790-a959-3552ed5e09e9" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Do not upload the texture into the existing Texture Set, because the system will interpret the newly uploaded texture set as an updated version of the original and overwrite it.
{% endhint %}

You will also need to specify the size of the new map. Make sure the physical dimensions match the real-world size represented by the newly uploaded texture:

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FYr1folIfByDZGeeWKzkJ%2Fsize.png?alt=media&amp;token=3a4c38ea-1401-4256-8e51-2a377990c327" alt=""><figcaption></figcaption></figure>

and then press *Save*.

Once it is saved, copy or remember the Texture Set ID (in this case 61012) and navigate to *Edit Material:*

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FO4fhk89VCyGmzVmfXBev%2Fimage.png?alt=media&amp;token=a976ff68-311d-4188-bc43-defc9fffd38f" alt=""><figcaption></figcaption></figure>

Then click *+ Add a new node* and select a new *Texture Set* from the menu.

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FBmhmlTg4RCWm2fpBHUgR%2Ftexture-set.png?alt=media&amp;token=5ff8996a-058b-4a36-8676-fcfa5a2a3138" alt=""><figcaption></figcaption></figure>

and add the *Texture Set* ID here:

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FLQguz8F3kruYTu3nmfEt%2Fnode-editr.png?alt=media&amp;token=0fad2017-5a34-4a82-9157-10977b8ec853" alt=""><figcaption></figcaption></figure>

As a final step, connect the UV output to the X-Y-Z input, and plug the Base Color into the Base Color input of the Principled BSDF node like so:

<figure><img src="https://1229207575-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv3R7xjvJcsIFNxg1zMmq%2Fuploads%2FY7TWn2hb1HAeRJINzGh1%2Fimage.png?alt=media&amp;token=a67b3bd7-751e-4fdf-98b5-205ced8ac5fc" alt=""><figcaption></figcaption></figure>

Once you are finished, save the material.
