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 URP Shaders. This is because built-in Lit shaders are not compatible with URP Shaders. For an overview of the mapping between built-in shaders and URP 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 URP Materials or Upgrade Selected Materials to URP 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 URP 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
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023