Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


Material variants

Learn about the benefits and limitations of using material variants to manage materials.
Read time 1 minuteLast updated a month ago

A material variant is a material that inherits the properties of a parent material. Use material variants to create a hierarchy of materials, to help you manage and maintain groups of similar materials more efficiently than creating duplicate copies.
For example, use material variants to manage outfits with a variety of color schemes, damaged and undamaged versions of scenery, or shiny and weathered instances of scenery.
You can do the following more efficiently with material variants compared to duplicate copies:
  • Change a parent material and automatically propagate those changes down to all the child materials.
  • Copy property values from a child material to its parent.
  • Prevent child materials modifying specific properties.
  • Change the parent of a child material.

Limitations

You can't use material variants to do the following:
  • Improve performance or scalability.
  • Change materials at runtime.

Similarities to prefab variants

Material variants are similar to prefab variants for GameObjects, but with the following key differences:
  • You can change the parent of a material variant.
  • You can lock properties so child materials can't override them.

Additional resources