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 Lightweight Render Pipeline instead, you must convert those Shaders to the LWRP Shaders. This is because built-in Lit shaders are not compatible with LWRP Shaders. For an overview of the mapping between built-in shaders and LWRP Shaders, see Shader mappings.

    To upgrade built-in Shaders:

    1. Open your Project in Unity, and go to Edit > Render Pipeline.
    2. According to your needs, select either Upgrade Project Materials to LightweightRP Materials or Upgrade Selected Materials to LightweightRP 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.

    Shader mappings

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

    Unity built-in shader Lightweight Render Pipeline shader
    Standard Lightweight Render Pipeline/Lit
    Standard (Specular Setup) Lightweight Render Pipeline/Lit
    Standard Terrain Lightweight Render Pipeline/Terrain/Lit
    Particles/Standard Surface Lightweight Render Pipeline/Particles/Lit
    Particles/Standard Unlit Lightweight Render Pipeline/Particles/Unlit
    Mobile/Diffuse Lightweight Render Pipeline/Simple Lit
    Mobile/Bumped Specular Lightweight Render Pipeline/Simple Lit
    Mobile/Bumped Specular(1 Directional Light) Lightweight Render Pipeline/Simple Lit
    Mobile/Unlit (Supports Lightmap) Lightweight Render Pipeline/Simple Lit
    Mobile/VertexLit Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Bumped Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Bumped Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Bumped Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Self-Illumin/Bumped Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Bumped Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Bumped Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Specular Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Bumped Diffuse Lightweight Render Pipeline/Simple Lit
    Legacy Shaders/Transparent/Cutout/Bumped Specular Lightweight Render Pipeline/Simple Lit
    Back to top
    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