Version: 2021.1
Using shader keywords with C# scripts
Shader variant collections

Using shader keywords with the material Inspector

In the Unity Editor, when you view a material in the material InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
, you can enable and disable its local shaderA program that runs on the GPU. More info
See in Glossary
keywords. This is useful for two reasons:

  • It allows artists to easily set different keyword values for different materials, without needing to use code.
  • When you enable a keyword using the [KeywordEnum] MaterialPropertyDrawer, Unity automatically disables the other keywords in a set. This ensures that exactly one keyword from a set is enabled at any time.

As with any shader settings or data, shader keywords are only available in the material Inspector when they are declared as material properties in the shader source file.

For shaders created in Shader Graph, keywords are material properties by default. This means that these settings are automatically available in the material Inspector. To change this, open the Blackboard, and change the Exposed property.

For hand-coded shaders, you must ensure that your ShaderLabUnity’s language for defining the structure of Shader objects. More info
See in Glossary
code defines a material property that represents the keyword set. The material property must have a type of Float, and must use the [Toggle], [ToggleOff], or [KeywordEnum] MaterialPropertyDrawer attribute to expose it correctly to the Inspector. For more information and examples, see the documentation for the MaterialPropertyDrawer API.

Using shader keywords with C# scripts
Shader variant collections