Shader Stripping
The shaders in the Universal Render Pipeline (URP) use shader keywords to support many different features, which can mean Unity compiles a lot of shader variants.
If you disable features in the URP Asset, URP automatically excludes ('strips') the related shader variants. This speeds up builds, and reduces memory usage and file sizes.
For example, if your project doesn't use shadows for directional lights, by default Unity still includes variants that support directional light shadows in your build. If you disable Cast Shadows in the URP Asset, URP strips these variants.
If you want to examine the code that strips shaders in URP, see the Editor/ShaderPreprocessor.cs file. The file uses the IPreprocessShaders API.
For more information on stripping shader variants, see the following pages:
- Check how many shader variants you have.
- See the standard guidance about shader stripping, which applies to all render pipelines.
Strip feature shader variants
By default, URP compiles variants where a feature is enabled, and variants where a feature is disabled.
To reduce the number of variants, you can do the following:
- Enable Strip Unused Variants in the URP Global Settings.
- Disable a feature in all URP Assets in your build, so URP keeps only variants where the feature is disabled.
Disable a feature
To let Unity strip variants related to a feature, make sure you disable it in all the URP Assets in your build.
Unity includes the following URP Assets in your build:
- The URP Asset you set as the default render pipeline asset in Graphics Settings.
- Any URP Asset you set as a Render Pipeline Asset in a Quality Settings level - even if you disable the level for the current build target.
| Feature | How to disable the feature |
|---|---|
| Additional lights | You can't strip the variants for this feature. |
| Ambient occlusion | Remove the Ambient Occlusion Renderer Feature in all Renderers that URP Assets use. |
| Decals | Remove the Decals Renderer Feature in all Renderers that URP Assets use. |
| Reflection Probe blending | Disable Probe Blending. |
| Reflection Probe box projection | Disable Box Projection. |
| Render Pass | Disable Native Render in all Renderers that URP Assets use. |
| Light Layers | Disable Light Layers. |
| Shadows from additional lights | You can't strip the variants for this feature. |
| Shadows from the main light | You can't strip the variants for this feature. |
Strip XR and VR shader variants
If you don't use XR or VR, you can disable the XR and VR modules. This allows URP to strip XR and VR related shader variants from its standard shaders.