Last reviewed 1 May 2026

Applies to

URP material migration Shader replacement workflow Imported asset compatibility fixes

Difficulty Intermediate

How to convert a SRP material to URP

If you import assets from another project or package, you may find that some materials do not look correct in your current Unity setup. One common reason is that the material was created for a different render pipeline.

For beginners, the core idea is:

• a material depends on a shader
• that shader must match the render pipeline the project is using
• if the shader does not match, the material may look wrong or fail entirely

If your project uses URP and the material was made for a different setup, you often need to convert or rebuild it so it works correctly in URP.

What URP Means

URP stands for Universal Render Pipeline.

It is one of Unity's Scriptable Render Pipeline options and is commonly used because it offers a flexible balance between visual quality and performance.

If your project is using URP, materials need shaders that are compatible with URP. A material built for another pipeline may not render correctly.

Signs a Material Needs Conversion

Common signs include:

• the material appears pink
• the object looks flat or missing details
• transparency behaves incorrectly
• lighting response is obviously wrong
• the shader name shows a pipeline mismatch

Pink is the most obvious warning sign, but a material can also be "wrong" without being pink.

Why This Happens

Materials store shader information. If the shader belongs to:

• the Built-in Render Pipeline
• another SRP setup
• an older incompatible shader package

then the material may not behave correctly in URP.

This is especially common when:

• importing older Unity assets
• moving content from another project
• opening tutorial content made for a different renderer

Before You Change Anything

Before converting materials:

1. Confirm the project is actually using URP
2. Save your scene
3. Back up the project or commit your current state
4. Test the conversion on a small set of materials first

This matters because conversion work can affect many assets at once, and it is much safer to test on a controlled example.

A Safe Beginner Workflow

The simplest safe process is:

1. Identify one broken or mismatched material
2. Inspect its current shader
3. Replace it with an equivalent URP shader
4. Reassign textures and values if needed
5. Check the result in the scene
6. Repeat for similar materials

Doing this one material at a time helps you understand what changed and what still needs attention.

How to Check the Current Shader

To inspect a material:

1. Select the material in the Project window
2. Look at the Inspector
3. Review the shader currently assigned to it

If the shader clearly belongs to a different render pipeline or an unsupported setup, that is a strong sign it needs replacement.

Replace the Shader With a URP-Compatible Shader

In most basic cases, the workflow is:

1. Select the material
2. Open the shader dropdown
3. Choose an appropriate URP-compatible shader

The exact shader choice depends on what the material is supposed to do.

For example:

• a standard opaque surface may use a general URP lit shader
• a simpler surface may use a lighter URP shader option
• special transparent or custom materials may need more careful matching

Why the Material May Still Look Wrong After Shader Swap

Changing the shader is often only part of the job.

After the shader changes, you may need to:

• reassign textures
• adjust smoothness
• correct metallic values
• reconfigure transparency
• check normal map usage
• tune color and emission

This happens because different shaders do not always map values in exactly the same way.

Convert in Small Batches

If you have a large imported asset pack, do not try to fix everything blindly in one giant pass.

Instead:

1. Pick one material type
2. Convert it
3. Check the result in scene lighting
4. Use that as the reference for similar materials

This is much easier than trying to fix thirty materials at once without knowing what a correct result should look like.

Common Beginner Mistakes

Converting everything at once

If the results are wrong, it becomes harder to know which change caused the issue.

Assuming the shader swap is enough

Many materials still need value and texture adjustments afterward.

Not testing in the actual scene

A material might look acceptable in isolation but still be wrong under the real lighting conditions of the world.

Forgetting transparency and special surface behavior

Some materials are more complex than a basic opaque surface and need additional tuning.

Practical Advice

• Confirm the project is using URP before troubleshooting URP materials
• Test on one material first
• Compare before and after in the real scene
• Keep notes if a certain imported asset pack needs a repeated shader replacement workflow

Helpful follow-up pages

• URP
• How to update materials to URP Unity 2020
• Converting custom shaders to the Universal Render Pipeline | Tutorial
• Creating and Managing Materials

Final Advice

Material conversion is usually less about one magic button and more about matching the material to the correct render pipeline and then checking the result carefully.

For beginners, the best approach is:

• identify the mismatch
• switch to a URP-compatible shader
• retune the material if needed
• test in scene

That slow, controlled approach is much safer than trying to mass-convert blindly.

Help! My material or shader looks wrong after changing it.

Check the assigned shader, texture slots, render pipeline, and platform target. Revert to the backed-up material if the conversion changed more than expected.

Help! Will this work on Quest or Android?

Assume mobile is stricter. Use mobile-safe shaders and test the Android build path before depending on the effect in a cross-platform VRChat project.

Related Navigation

• Unity3D Documentation
• Unity Troubleshooting
• VRChat Documentation

References

• Unity Documentation
• Unity Manual
• Unity URP Manual