Version: Unity 6.4 (6000.4)
Language : English
Create and assign a material
Access material properties in a script

Convert material assets to URP or HDRP

When you migrate your project from 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
to either the Universal Render Pipeline (URP) or the High Definition Render Pipeline (HDRP), you need to convert your materials, otherwise, the materials appear bright pink in SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary
view.

A bright pink cube in Scene view.
A bright pink cube in Scene view.

Notes:

  • Make sure there are no shader-related errors in the console, or in the InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
    See in Glossary
    window when you select a material.

  • If your assets use custom shadersA program that runs on the GPU. More info
    See in Glossary
    , refer to Convert custom shaders for URP compatibility.

Convert Built-In Render Pipeline materials to URP

To convert some or all material assets from the Built-In Render Pipeline to URP:

  1. Back up your Built-In Render Pipeline material assets.

  2. In your URP project, go to Window > Rendering > Render Pipeline Converter.

  3. Select Built-in to URP from the dropdown.

  4. Enable Material Upgrade.

  5. Select Initialize Converters.

  6. Select the material assets you want to convert to URP.

  7. Select Convert Assets.

Note: If the console or the Inspector window displays error messages when you select a material, there’s an issue with a shader that an automatic converter can’t solve.

For more information, refer to Convert assets using the Render Pipeline Converter.

Convert Built-In Render Pipeline materials to HDRP

To convert all material assets from the Built-In Render Pipeline to HDRP:

  1. Back up your Built-In Render Pipeline material assets.

  2. In your HDRP project, go to Edit > Rendering > Materials > Convert All Materials using HDRP upgraders.

To convert only some material assets from the Built-In Render Pipeline to HDRP:

  1. Back up your Built-In Render Pipeline material assets.

  2. In your HDRP project, select your Built-In Render Pipeline material assets in the Project windowA window that shows the contents of your Assets folder (Project tab) More info
    See in Glossary
    .

  3. Go to Edit > Rendering > Materials > Convert Selected Materials using HDRP upgraders.

For more information, refer to Convert materials and shaders (HDRP).

Additional resources

Create and assign a material
Access material properties in a script