Why does my Substrate material error in this project?

Substrate is opt-in. Project Settings → Rendering → Substrate Materials → Enable. Restart editor and rebuild shaders. Until enabled, Substrate nodes don't compile.

Mixing Standard and Substrate?

Once enabled, all materials migrate to Substrate stack internally. Existing Standard nodes still author similar; output is unified. Plan migration; existing scenes may need rebake.

Performance comparison?

Substrate is more flexible (multi-layer mats) but ~10-20% more expensive at typical settings. Production: profile both before commit.

Fix: Substrate Material Errors In Non-Substrate Project

Quick answer: Project Settings → Rendering → Substrate Materials → Enable. Restart editor; rebuild shaders.

Imported a Marketplace asset using Substrate nodes. Errors. Project hadn’t enabled Substrate.

The Fix

Project Settings → Rendering:
  Substrate Materials:
    Enable Substrate:        true
    Bytes Per Pixel:          80   // quality vs perf

Restart editor.
Tools → Shader Compilation → Recompile shaders.

Substrate becomes the default material domain. Existing materials still work; new Substrate nodes compile.

Verifying

Substrate material previews. Frame budget: confirm acceptable for the project.

“Enable. Rebuild. Substrate live.”

Related Issues

For Lumen software, see Lumen software. For TAA ghost, see TAA.

Enable Substrate. Compile.