---
title: How to Upload an Avatar to VNyan
description: "Learn how to upload an avatar to VNyan! "
source: "https://nodecraft.com/support/games/vnyan/how-to-upload-an-avatar-to-vnyan"
image: "https://dynamic-assets.nodecraft.com/signedurl/w7vokBAexMnVlnMZ1Q/image.jpg?modifications=W3sibmFtZSI6ImdhbWVfYmciLCJpbWFnZV91cmwiOiJodHRwczovL2Ntcy1hLm5vZGVjcmFmdC5jb20vZi8xMzM5MzIvMjAwMHg1NTAvNDYzN2E2NmVhYi92bnlhbl9iYW5uZXIucG5nL20vIn0seyJuYW1lIjoiZ2FtZV9sb2dvIiwiaW1hZ2VfdXJsIjoiaHR0cHM6Ly9jbXMtYS5ub2RlY3JhZnQuY29tL2YvMTMzOTMyLzM3NXgyMDAvMTAyOWQyOTBlMC9sb2dvLnBuZy9tLyJ9LHsibmFtZSI6ImN0YV90ZXh0IiwidGV4dCI6IkNyZWF0ZSB5b3VyIG93biBzZXJ2ZXIhIn0seyJuYW1lIjoidGV4dCIsInRleHQiOiJIb3cgdG8gVXBsb2FkIGFuIEF2YXRhciB0byBWTnlhbiJ9XQ&s=09861a7735d7e7e32664c26156787119dc6a05468120e94a62c8e7c92d283c62"
published: "2025-12-16T16:40:52.342Z"
updated: "2025-12-16T16:40:52.305Z"
---

# How to Upload an Avatar to VNyan

Learn how to upload an avatar to VNyan! 

# How to Upload an Avatar to VNyan

This guide walks you through uploading and loading an avatar in VNyan, whether you are setting one up for the first time or switching to a new model.

## Uploading / Loading Your Avatar

### First-Time Setup

1. Launch **VNyan**.
2. On first launch, VNyan will automatically open the **Setup Wizard**.

  ![VNyan welcome screen showing avatar file loader, "Load" button, auto-load avatar checkbox, and "Skip Wizard" and "Ok" buttons on a dark purple panel.](https://cms-a.nodecraft.com/f/133932/455x456/dbd6c4a4ca/screenshot-2025-12-15-184029.png/m/)
3. Follow the on-screen instructions to add your avatar.
4. Make sure your model is in one of the supported formats:

  - **VRM**
  - **VRM 1.0**
  - **VSFAvatar format**
5. Upload your VTuber model in the desired field.
6. Complete the wizard and confirm your avatar loads correctly.

### Changing an Existing Avatar

If you already have an avatar loaded and want to switch to a new one:

1. Launch **VNyan**.
2. Open the **Right-Side Menu**.
3. Select **Load** **Avatar**.

  ![Vertical purple sidebar menu with rounded buttons and icons; the "Load Avatar" button is outlined in red.](https://cms-a.nodecraft.com/f/133932/160x465/5f27136490/4hdx1ko7gd.png/m/)
4. Upload your new avatar file.
5. Adjust settings and configuration as needed (expressions, tracking, offsets, etc.).

## Troubleshooting

- **Avatar does not appear after loading**

Verify the model format is **VRM**, **VRM 1.0**, or **VSFAvatar**. Restart VNyan and try again.

- **Setup Wizard does not appear**

Use the **Load** option from the right-side menu to manually add your avatar.

- **Avatar loads incorrectly or appears distorted**

Check the model’s **scale and orientation** settings, and confirm the avatar was exported correctly from your modeling software.

- **File will not upload**

Ensure the file is **not zipped** and that VNyan has permission to access the folder location.

## Conclusion

Uploading an avatar to VNyan is a quick and straightforward process. First-time users can rely on the built-in setup wizard, while returning users can easily swap avatars using the Load option. As long as your model is in a supported format and properly configured, you’ll be ready to stream or record with VNyan in just a few steps.
