You upload a custom VRChat avatar through the VRChat SDK inside Unity: open the SDK Build Control Panel, log in, and use Build & Publish once your model is set up with an Avatar Descriptor. Your account also needs the New User trust rank or higher before the publish button works at all.
What you need before you can upload
Two things have to be ready before the SDK lets you publish anything.
- An avatar set up in Unity: a model with a Humanoid rig and a VRChat Avatar Descriptor component attached. The SDK will not build without one.
- The VRChat Creator Companion and SDK installed, which also installs the correct Unity version for the current SDK release. A mismatched Unity or SDK version is the most common reason the Control Panel breaks on first use.
Your account also needs to be at New User trust rank or higher. Fresh accounts start at Visitor and cannot upload anything. You reach New User by verifying your email and spending time in the game, commonly cited as roughly twelve or more in-game hours, and there is no way to skip or buy past this requirement.
Step 1: open the SDK and log in
In Unity, go to VRChat SDK, then Show Control Panel. On first use you land on the Authentication tab, where you log in with the VRChat account the avatar should belong to, including a two factor code if you have it enabled on that account. The panel then shows your account name and current trust rank, which is a useful first check if the publish button later stays disabled.
Step 2: Build and Test before you publish
Switch to the Builder tab. The SDK validates the avatar, lists any blocking errors or warnings, and shows the performance rank it would get on the current platform. Click Build & Test first: this makes a temporary local copy you can wear and check in your own client, without uploading anything or exposing it to other players. Use this step to check view height, lip sync, blinking and eye look, and any toggles or physics bones before committing to a real upload. There is no limit on how many times you can test, so fix issues in Unity and build again as needed.
Step 3: Build and Publish
Once the test build looks right, click Build & Publish for Windows. The SDK compiles the avatar, then shows a publish form inside Unity where you set a name, a thumbnail captured from the scene camera, and the visibility, which should stay Private while you are still testing changes. Accept the content guidelines checkbox and click Upload. After the upload finishes, restart VRChat and look for the avatar under the Other or Uploaded tab in your avatar menu, not Favorites, since new uploads usually only appear there after a full relaunch.
The first time you publish, the SDK assigns the avatar a blueprint ID. That ID ties every future re-upload, including a Quest build, to this same avatar entry, so do not change or lose track of it once it exists.
Adding a Quest build
VRChat treats PC and Quest as two separate builds published under one shared blueprint ID. If you only publish the Windows version, Quest players will see a generic fallback avatar instead of your real one, which is one of the most common complaints new creators run into.
- Publish the PC version first. This is what assigns the blueprint ID that everything else attaches to.
- Optimize a Quest copy to the platform's limits: under 20,000 triangles, VRChat Mobile shaders only, and small textures of 1024 by 1024 pixels or less.
- In Unity, go to File, then Build Settings, select Android, and switch platform. The first switch can take several minutes while Unity reimports assets for the new target.
- Open the Control Panel again, confirm the avatar still shows the same blueprint ID as the PC upload, and click Build & Publish for Android.
Publishing to the same blueprint ID adds the Quest variant to your existing avatar rather than creating a second, unrelated one, which is the root cause behind most reports of an avatar working on PC but not showing up for Quest friends.
Can you upload without Unity?
Not for a real custom avatar. The SDK that publishes to your account only runs inside Unity, and there is no official web uploader for arbitrary models. The one real exception is a web-based avatar maker built entirely from that tool's own parts, which lets you assemble and upload a simple avatar without Unity. The moment you want a custom base model, toggles, or a Quest build, you are back to the SDK.
Before you start building and uploading, our VRChat guides cover account and safety basics, and the VRChat hub has the rest of our coverage for the game.
FAQ
Why is the Build and Publish button greyed out?
Usually because you are not logged into the SDK, your account is still at Visitor trust rank, or the Builder tab shows a blocking error such as a missing Avatar Descriptor or a rig that is not set to Humanoid.
I uploaded my avatar but can't find it in-game. Why?
Restart VRChat fully, since new uploads typically only appear after a relaunch, and check the Other or Uploaded tab rather than Favorites.
What trust rank do I need to upload an avatar?
New User or higher. Fresh Visitor accounts cannot upload until they verify their email and spend enough time in the game.
Why can't my Quest friends see my avatar?
You likely only published the Windows build. Switch the platform to Android in Unity, optimize the model to Quest's limits, and publish to the same blueprint ID as the PC version.