Version: 2022.1
Using shader keywords with C# scripts
Shader variant stripping

Using shader keywords with the material Inspector

In the Unity Editor, when you view a material in the material Inspector, you can enable and disable its local shader 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 ShaderLab 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.

Shader "Custom/ApplyEffectIfKeywordIsOn"
{
    Properties
    {
        // Display a toggle in the Material's Inspector window
            [Toggle] _Keyword ("Keyword", Float) = 0.0
    }

    SubShader
    {
        Pass
        {
            #pragma shader_feature _Keyword

            fixed4 frag(v2f i) : SV_Target
            {
                    #if _Keyword
                        // If _Keyword is on at build time, Unity creates a shader variant that uses the following code
                        ApplyEffect();
                    #endif
            
            // rest of shader code...
            }
        }
    }
}

For more information and examples, see the documentation for the MaterialPropertyDrawer API.

Using shader keywords with C# scripts
Shader variant stripping