Upgrading your shaders | Package Manager UI website
docs.unity3d.com
    Show / Hide Table of Contents

    Upgrading your shaders

    If your Project uses shaders from the built-in render pipeline, and you want to switch your Project to use the Universal Render Pipeline instead, you must convert those Shaders to the UniversalRP Shaders. This is because built-in Lit shaders are not compatible with UniversalRP Shaders. For an overview of the mapping between built-in shaders and UniversalRP Shaders, see Shader mappings.

    To upgrade built-in Shaders:

    1. Open your Project in Unity, and go to Edit > Render Pipeline > Universal Render Pipeline.
    2. According to your needs, select either Upgrade Project Materials to UniversalRP Materials or Upgrade Selected Materials to UniversalRP Materials.

    Note: These changes cannot be undone. Backup your Project before you upgrade it.

    Tip: If the Preview thumbnails in Project View are incorrect after you've upgraded, try right-clicking anywhere in the Project View window and selecting Reimport All.

    For SpeedTree Shaders, Unity does not re-generate Materials when you re-import them, unless you click the Generate Materials or Apply & Generate Materials button.

    Shader mappings

    The table below shows which UniversalRP shaders the Unity built-in shaders convert to when you run the shader upgrader.

    Unity built-in shader Universal Render Pipeline shader
    Standard Universal Render Pipeline/Lit
    Standard (Specular Setup) Universal Render Pipeline/Lit
    Standard Terrain Universal Render Pipeline/Terrain/Lit
    Particles/Standard Surface Universal Render Pipeline/Particles/Lit
    Particles/Standard Unlit Universal Render Pipeline/Particles/Unlit
    Mobile/Diffuse Universal Render Pipeline/Simple Lit
    Mobile/Bumped Specular Universal Render Pipeline/Simple Lit
    Mobile/Bumped Specular(1 Directional Light) Universal Render Pipeline/Simple Lit
    Mobile/Unlit (Supports Lightmap) Universal Render Pipeline/Simple Lit
    Mobile/VertexLit Universal Render Pipeline/Simple Lit
    Legacy Shaders/Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Bumped Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Bumped Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Bumped Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Bumped Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Bumped Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Bumped Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Specular Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Bumped Diffuse Universal Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Bumped Specular Universal Render Pipeline/Simple Lit
    Back to top Copyright © 2019 Unity Technologies
    Generated by DocFX