VRChat avatar upload stuck on "Building Avatar" or uploading - fix

Want it checked automatically? Avatar Setup Doctor finds what's blocking your upload in one click - free version. Try it free

What you see on screen:

What it means

The build or upload is hanging. According to VRChat, the usual causes are a red error in the Unity Console, or your internet provider having bad routing to VRChat's content servers (or filtering/throttling the connection).

Common causes

• A red Console error stopped the build
• Bad routing, filtering or throttling between your ISP and VRChat's content servers
• A VPN, proxy or security software getting in the way
• The SDK panel got stuck after logging in or switching scenes

How to fix it

1. Open the Console, press Clear, build again, and fix the first red error
2. If there's no error: for routing problems VRChat suggests trying Cloudflare WARP. If you already use a VPN or WARP, try turning it off instead
3. Close and reopen the SDK panel, log out and back in, or restart Unity
4. Update the VRChat SDK in VCC or ALCOM
5. If it still hangs, report it on VRChat's feedback board or contact Support

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

Related errors

• VRChat SDK "Missing Credentials" even though you're logged in
• VRChat "Avatar Failed Upload" / "Failed to upload"
• "All compiler errors have to be fixed before you can enter playmode" in a VRChat avatar project
• Uploaded VRChat avatar not showing, or others see a different avatar (robot / fallback)

See other errors