VRChat Avatar Error Guide日本語Free tool
VRChat Avatar Error Guide

VRChat Quest "Avatar uses unsupported shader" (pink on Quest / Android) - fix

Quick fix
  1. Duplicate the avatar and make the Quest version from the copy (keep the PC original)
  2. Change the copy's materials to VRChat/Mobile/Toon Lit or similar

Want it checked automatically? Avatar Setup Doctor checks Quest shaders and your build target in one click - free version. Try it free

What you see on screen:

Avatar uses unsupported shader '…'. You can only use the shaders provided in 'VRChat/Mobile' for Quest avatars.

What it means

With the build target set to Quest (Android), the avatar uses shaders Quest can't run. Quest avatars can only use VRChat/Mobile shaders, so they show up pink or fail to upload.

Common causes

How to fix it

  1. Duplicate the avatar and make the Quest version from the copy (keep the PC original)
  2. Change the copy's materials to VRChat/Mobile/Toon Lit or similar
  3. Check that polygon and material counts fit Quest limits

Before you change anything, make a full copy of your project folder so you can go back.

Fix this automaticallyAvatar Setup Doctor adds a window to Unity. Press Diagnose and it lists what's wrong with your avatar project, why, and how to fix it - the paid version fixes many issues in one click. Free version available.
For this problem, it lists shaders Quest can't use, and the paid version makes a Quest copy with replaced shaders in one click (the original avatar is untouched).
Get Avatar Setup Doctor (Free version available)

Related errors

See other errors