Upgrade material assets to URP or HDRP
Upgrade your Built-In Render Pipeline materials to prevent them from appearing bright pink in Scene view.
Read time 2 minutesLast updated 24 days ago
When you upgrade your project from the Built-In Render Pipeline (BiRP) to either the Universal Render Pipeline (URP) or the High Definition Render Pipeline (HDRP), you need to upgrade your materials, otherwise, the materials appear bright pink in Scene view.
A bright pink cube in Scene view.
Notes:
-
Make sure there are no shader-related errors in the console, or in thewindow when you select a material.Inspector
?
-
If your assets use custom shaders, refer to Upgrade custom shaders for URP compatibility.
Upgrade BiRP materials to URP
To upgrade all material assets from BiRP to URP:
-
Back up your Built-in Render Pipeline material assets.
-
In your URP project, go to Window > Rendering > Render Pipeline Converter.
-
In the Render Pipeline Converter window, select Built-in to URP from the drop-down, enable Material Upgrade, then select Initialize and Convert.
To upgrade only some material assets from BiRP to URP:
-
Back up your Built-in Render Pipeline material assets.
-
In your URP project, select your Built-in Render Pipeline material assets.
-
Go to Edit > Rendering > Materials > Convert Selected Built-in Materials to URP.
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.
Upgrade BiRP materials to HDRP
To upgrade all material assets from BiRP to HDRP:
-
Back up your Built-in Render Pipeline material assets.
-
In your HDRP project, go to Edit > Rendering > Materials > Convert All Built-in Materials to HDRP.
To upgrade only some material assets from BiRP to HDRP:
-
Back up your Built-in Render Pipeline material assets.
-
In your HDRP project, select your Built-in Render Pipeline material assets in the Project window.
-
Go to Edit > Rendering > Materials > Convert Selected Built-in Materials to HDRP.
For more information, refer to Convert materials and shaders (HDRP).