Converting prebuilt shaders from the Built-In Render Pipeline to URP reference

After you use the Material Shader Converter in the Render Pipeline Converter, Unity converts the selected prebuilt shadersA program that runs on the GPU. More info
See in Glossary to its corresponding Universal Render Pipleine (URP) shaders.

Note: This page is about converting prebuilt shaders to URP only. For more information on how to convert custom shaders to URP, refer to Upgrade custom shaders for URP compatibility.

Shader mapping

The following table shows which URP shaders the Built-In Render PipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
See in Glossary shaders convert to when you use the Render Pipeline Converter.

Define upgrade paths for shaders

To define upgrade paths for shaders, do the following:

• Map an old shader to a new one with a custom MaterialUpgrader.
• Expose the upgrader to the system with IMaterialUpgradersProvider.

// This class defines the upgrade rule from an old shader to a new shader
public class MaterialUpgraderExample : MaterialUpgrader
{
    // Priority determines order — higher values override lower-priority upgraders
    public int priority => 1000;
    public MaterialUpgraderExample(string oldShaderName, string newShaderName)
    {
        if (oldShaderName == null)
            throw new ArgumentNullException(nameof(oldShaderName));

        // Maps the old shader to the new shader with optional property remapping (null here)
        RenameShader(oldShaderName, newShaderName, null);
    }
}

// This provider makes the upgrader discoverable by the upgrader system.
// It declares support for the Universal Render Pipeline and exposes the custom upgrade rule.
[SupportedOnRenderPipeline(typeof(UniversalRenderPipeline))]
private class ExampleMaterialProvider : IMaterialUpgradersProvider
{

    public IEnumerable<MaterialUpgrader> GetUpgraders()
    {
        // Replace "SomePathToShader" and "MappingShaderPath" with actual shader names/paths
        yield return new MaterialUpgraderExample("SomePathToShader", "MappingShaderPath");

        // Add as many upgraders you need
    }
}

Additional resources

• Render Pipeline Converter
• Convert assets and quality levels from the Built-In Render Pipeline to URP
• Upgrade custom shaders for URP compatibility
• Prebuilt shaders render pipeline compatibility reference
• Error and loading shaders