Why is my VRChat avatar pink? (and other import problems)

Updated Nov 12, 2026

You imported an avatar or outfit and something’s wrong. These are the problems almost everyone hits once, and how to fix them.

The avatar (or outfit) is bright pink

Pink means Unity can’t find the shader: the program that draws the material. Avatars from BOOTH are almost always made with lilToon or Poiyomi, and the shader isn’t included in the avatar package.

1. Check the readme (or the listing’s 前提 / 必須, “required”) for which shader it uses.
2. Install it:
   • lilToon: add it through the Creator Companion (or ALCOM), or import the .unitypackage from lilToon’s page.
   • Poiyomi: add it through the Creator Companion, or import from Poiyomi’s site.
3. Wait for Unity to finish importing. The pink should go away by itself.

Still pink? Right-click the avatar’s folder in the Project window and choose Reimport. If the readme asks for a specific shader version, use that one.

Some parts are pink, the rest is fine

An outfit or accessory uses a different shader from the base. Install that one too; you can have lilToon and Poiyomi in the same project.

Red errors in the Console, nothing works

Scripts that don’t compile stop the VRChat SDK from working, so the Upload button may be missing or greyed out.

• Open Window → General → Console and read the first red error.
• It often names an old tool, like Dynamic Bone. VRChat uses PhysBones now; delete the folder the error points to, or install the tool the readme asks for.
• Errors from a package you don’t use any more? Remove it in the Creator Companion.

“Missing Prefab” or missing objects

The package needs something you haven’t imported yet: often the base itself, when you import an outfit or a pre-made avatar setup first. Import the base, then the outfit again.

Wrong Unity version

VRChat uses Unity 2022.3.22f1. Upgrading to a newer version stops your avatar from loading in VRChat. Always create and open projects from the Creator Companion, which picks the right version. See VRChat’s current Unity version.

The Upload button says there are problems

The SDK’s Builder tab lists what’s blocking the upload, usually with an Auto Fix button. Common ones: the avatar has no VRC Avatar Descriptor (you dragged in the wrong object; use the avatar’s prefab from its folder), or it’s over a limit for its platform.

New to all this? Start with how to upload a BOOTH avatar.