Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


Upgrade material assets to Scriptable Render Pipeline

Convert your Built-In Render Pipeline materials for URP and HDRP compatibility to prevent them from appearing bright pink in Scene view.
Read time 2 minutesLast updated 22 days ago

When you upgrade your project from the Built-In Render Pipeline (BiRP) to a Scriptable Render Pipeline (SRP) such as the Universal Render Pipeline (URP) or the High Definition Render Pipeline (HDRP), you need to upgrade your materials. If you don't upgrade your materials, they appear bright pink in Scene view.

A bright pink cube in Scene view.

Notes:

Upgrade Built-In materials to your current SRP

These menu options upgrade Built-In Render Pipeline materials to the currently active Scriptable Render Pipeline in your project.
Important
Back up your Built-in Render Pipeline material assets before proceeding. This conversion modifies materials and cannot be easily undone.
To upgrade all material assets in your project:
  1. Go to Edit > Rendering > Materials > Convert All Built-In Materials to Current SRP.
  2. In the confirmation dialog, select Proceed to start the conversion.
To upgrade only selected material assets:
  1. In the Project window, select the Built-in Render Pipeline material assets you want to convert.
  2. Go to Edit > Rendering > Materials > Convert Selected Built-In Materials to Current SRP.
  3. In the confirmation dialog, select Proceed to start the conversion.
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.

Additional resources