What merging masks does in Substance Painter

Merging masks in Substance Painter combines two or more mask layers into a single mask, reducing the number of layers in your project while keeping the visual result the same. When you merge masks, Substance Painter calculates how each mask affects the layers beneath it and bakes that relationship into one unified mask. This is useful when you have built up several masks to control where effects appear on your model, and you want to simplify your layer stack without losing the detail you created.

The merge operation works differently depending on whether your masks are stacked directly on top of each other or nested within layer groups. Understanding which masks you can merge together, and in what order, prevents you from accidentally flattening detail you meant to keep separate.

Key Takeaways

  • Merging masks combines multiple mask layers into one, reducing clutter in your layer stack while preserving the visual effect on your model.
  • You can only merge a mask with the layer directly beneath it—Substance Painter does not merge multiple masks into a single new mask in one operation.
  • Right-click a mask layer and select "Merge Down" to combine it with the layer below, or use the Layer menu at the top of the screen.
  • After merging, you lose the ability to edit the individual masks separately, so save a backup version of your project before merging if you think you might need to adjust them later.

How to merge a mask with the layer below it

Select the mask layer you want to merge by clicking it in the Layers panel on the right side of your screen. The layer will highlight in white to show it is selected. Make sure the layer below it is the one you actually want to merge into—once you merge, the mask becomes part of that layer and cannot be separated again.

Right-click the selected mask layer and look for "Merge Down" in the context menu. Click it. Substance Painter will calculate how the mask affects the layer beneath and combine them into a single layer. The visual appearance of your model stays the same, but your layer count drops by one.

Alternatively, go to the Layer menu at the top of the screen, hover over "Merge", and select "Merge Down". Both methods do the same thing—use whichever feels faster to you.

When merging masks makes sense

Merge masks when your layer stack has grown large and you have finished adjusting a particular area of your model. For example, if you created three separate masks to control rust, weathering, and dirt on a metal surface, and you are happy with how they look together, merging them into a single layer frees up visual space in your Layers panel and makes the project slightly faster to work with.

Merging is also useful before exporting your textures. A flatter layer structure can make it easier to bake out your final maps without accidentally leaving masks that should have been merged into the final result.

Do not merge masks if you think you might need to adjust them independently later. Once merged, you cannot separate them again without undoing back to before the merge. If you are still experimenting with how masks interact, keep them separate until you are confident in the result.

The difference between merging and flattening

Merging a mask combines it with the single layer directly below it. Flattening, by contrast, collapses your entire layer stack—all masks, all paint layers, all groups—into one single layer. Substance Painter calls this "Flatten Image" and it lives in the Layer menu.

Use "Merge Down" when you want to combine specific layers while keeping others separate. Use "Flatten Image" only when you are completely finished editing and ready to export, because flattening destroys all layer information and cannot be undone except by stepping back through your undo history.

Merging masks inside layer groups

If your masks are organized inside a layer group (a folder in your Layers panel), you can merge them the same way—right-click and select "Merge Down". The mask will merge with whatever layer is directly beneath it, whether that is another mask, a paint layer, or the bottom of the group.

If you want to merge all the masks within a group without affecting layers outside the group, make sure the layer below your mask is still inside the same group. If you merge a mask and the layer below it is outside the group, the merge will still happen, but the result will be in the lower layer's location, which can be confusing to track.

Undoing a merge if you change your mind

If you merge masks and immediately realize you made a mistake, press Ctrl+Z (Windows) or Command+Z (Mac) to undo. Substance Painter will restore the separate mask layers and you can try again.

If you have done other work since the merge, you can step backward through your undo history by pressing the undo shortcut multiple times, or by going to Edit menu and selecting "Undo" repeatedly. Each undo step takes you back one action. However, if you have closed and reopened the project, the undo history is gone—this is why saving a backup before merging is a good habit if you are unsure about the decision.

Why your merge option might be grayed out

The "Merge Down" option appears grayed out (disabled) when the selected layer is at the very bottom of your layer stack, because there is no layer below it to merge into. Move up one layer and try again.

It can also be grayed out if you have selected a layer group instead of an individual mask or paint layer. Click on a specific layer inside the group, not the group folder itself, and the merge option will become available.

Frequently Asked Questions

Can I merge multiple masks at once?

No. Substance Painter merges one layer with the layer directly below it. To merge three masks together, you merge the top two first, then merge the result with the third. This takes three separate merge operations, but the end result is the same as if you could merge all three at once.

What happens to the mask's opacity and blend mode when I merge?

Substance Painter calculates the mask's opacity and blend mode into the final result before merging. The visual effect stays the same, but the opacity and blend mode settings are no longer adjustable after the merge because they are now baked into the layer itself.

Can I merge a mask with a paint layer?

Yes. A mask can sit on top of a paint layer, and merging them combines the mask's effect with the paint layer beneath. The result is a single paint layer with the mask's effect permanently applied to it.

Does merging masks affect my final texture export?

No. Merging masks does not change how your textures look when exported. The visual result is identical whether your masks are separate or merged. Merging is purely for organization and project performance—it does not alter the final output.

Should I merge masks before baking textures?

It is not required, but some artists prefer to merge masks before baking to simplify the layer structure and reduce the chance of accidentally leaving a mask active that should be hidden. Check your baking settings to make sure all the layers you want to include are visible before you bake, whether merged or not.