Skip to main content

Avatar Appears Purple

How to deal with a symptom where an avatar's material in the scene is shown entirely in purple.

Cause​

The purple color is the fallback Unity displays when a material can't resolve its shader correctly. It happens due to a mismatch between Universal Render Pipeline (URP) and Built-in / legacy shaders, or due to shader import order issues.

For VRM Avatars​

This can happen right after importing a VRM. It is caused by shader resolution failing in time during the initial import, and is resolved by importing it again (reimport).

Reimport Steps​

  1. In the Project window, select the target .vrm file (or the Prefab folder generated from the VRM).
  2. Right-click → choose Reimport.
  3. Once the import completes, check the scene.

The material should now be applied correctly and shown in its original colors.