Smart Material Studio › Create a smart material
Guide

How to create a Substance Painter smart material

A smart material is a reusable stack of layers, masks and effects that adapts to whatever mesh you drop it on. Here is what one actually is, how to build and save it in Substance 3D Painter, and a faster way to get the stack started.

What a smart material actually is

In Substance 3D Painter a smart material is a saved group of layers - fills, paint layers, masks and generator/filter effects - stored on your shelf as a .spsm resource. When you apply it to a new mesh, its generators re-evaluate against that mesh's baked maps (curvature, ambient occlusion, thickness, world-space normals), so edge wear lands on real edges and dirt collects in real cavities. That mesh-awareness is the whole point: one material, many models, believable every time.

The honest constraint: the .spsm format is closed. Adobe publishes no spec, and it can only be authored inside Painter. No browser tool can hand you a drop-in .spsm file - anything claiming to is promising something that cannot work.

Build one by hand (the standard way)

  1. Bake your mesh maps first - curvature, AO, normal, thickness, world-space normal. Generators need them.
  2. Start with a base fill layer covering base color, roughness and metallic for the surface's dominant look.
  3. Stack detail layers on top - a grime pass, an edge-wear pass, a colour-variation pass - each a fill layer with a mask.
  4. Drive the masks with generators (Metal Edge Wear, Dirt, Curvature) so wear and grime follow the mesh, not hand-painted strokes.
  5. Right-click the group → Create smart material. It is saved to your shelf as a reusable .spsm.

Metallic-roughness channels to set

A complete material touches the metallic-roughness set. At minimum, define base color, roughness and metallic; add normal, height and AO for surface detail, and emissive/opacity where the surface needs them.

ChannelWhat it controls
Base ColorAlbedo / diffuse colour, with no lighting baked in
RoughnessMicro-surface: 0 is mirror-smooth, 1 is fully matte
MetallicDielectric (0) vs metal (1) - keep it near 0 or 1
NormalTangent-space surface detail direction
HeightDisplacement detail; also drives normal and parallax
Ambient OcclusionBaked contact shadow in crevices

The faster start: generate the stack

Building the same base stack by hand for every new material is repetitive. Smart Material Studio lets you design the material in the browser - pick a theme, tune each channel, preview it in 3D - then export a Painter Python script that builds the folder, the per-channel fill layers and the generator masks on your active texture set. You run it in Painter and get a real, editable stack to refine, then save as your own .spsm.

It is not a replacement for authoring in Painter; it is a head start that skips the boilerplate.

Design a material now - free

Pick a theme, tune every channel, preview it in 3D, then export the Painter script.

Open the app

FAQ

Can I download a ready-made .spsm file?

No, and neither can any external tool - the .spsm format is closed and only Painter can author it. The workable path is to generate a Painter Python script that builds the layer stack inside Painter, then save that as your own smart material.

Do smart materials need baked mesh maps?

Yes, for the mesh-aware parts. Generators like Metal Edge Wear and Dirt read baked curvature, ambient occlusion and thickness maps, so bake those before you apply the material.

What is the difference between a smart material and a smart mask?

A smart material is a full stack of layers and effects; a smart mask is just a reusable mask (generators plus paint) you drop onto a single layer. Both re-evaluate against the mesh.