Content Creators
Uploading Wearables

Uploading Wearables

Once you export your wearable, you’ll have to upload it to the builder. This document will cover the process of uploading wearables.

Uploading Your File #

Remember that you need to create a collection before you can upload your file. If you don’t know how to do that, check Creating a Collection . To upload your wearable, just drag and drop the file on the New Item window or browse your computer. It will automatically detect if the file is an emote or wearable. Remember that the collection max file size is 3MB.

When you upload the file, you will be asked to select a body shape, enter a name and define the rarity and the category. You can also add the thumbnail for the wearable.

Body Shape #

To ensure that your wearables can be worn by the intended avatars, you need to upload separate GLB files for each body shape. If you have two separate versions of the wearable, one for male and one for female, you can add one of the representations during the upload process and then add the other later using the editor. If your wearable is meant to be unisex, make sure to upload a single GLB file that is designed to fit both male and female versions.

Rarity #

Select the Rarity of your item.

Rarity Number of Items
Unique 1
Mythic 10
Exotic 50
Legendary 100
Epic 1,000
Rare 5,000
Uncommon 10,000
Common 100,000

Category #

Wearables are organized into different categories, depending on what part of an avatar they modify. Select the appropriate category for your item.

Custom Thumbnails #

You can add your own custom thumbnail by clicking on the camera icon and browsing your computer. The thumbnail must be 256px square .png file with transparent background. Collections containing thumbnails without transparent backgrounds will not be accepted by the Curation Committee.

⚠️ Having a good render of your wearable is crucial in making it more appealing to potential users in the marketplace. It’s important to avoid adding any graphics other than the wearable itself, because this may cause the curation committee to reject it.

Properties #

Below the thumbnail you’re going to find the properties of your wearable, number of triangles of your model, number of materials and textures.

Uploading Mouth, Eyes and Eyebrows #

The mouth, eyes and eyebrows category have a different behaviour in the editor because these are just .png files. To upload these just drag and drop the png file as a transparent image (256X256 pixels). Mouth is going to be automatically tinted by skin color, same for the eyebrows tinted by the hair color.

If you want the asset to be masked, so a part of the mouth or eyebrows is not affected by the tinting, upload a zip file with both the png and the mask files. Remeber that the mask file should have a suffix “_mask” in order to work.

After that uploading your wearables you will end up with a screen like this, that shows the items in your collection.

Setting the Price of Your Wearables #

Once you publish your collection and it gets approved, you can then enable the sales on your collection.

You can set the price of your wearable by clicking on Put up for sale. This can all be edited anytime, so don’t worry if you want to change it later on. Prices are set in MANA. Remember that when you mint wearables, they are minted directly on Matic/Polygon. When a user purchases your item, the transaction will be conducted in Matic/Polygon MANA.

You could also Make it Free, which means that the price will be set as 0 MANA and the beneficiary address will be null. Know that making it free (primary sale) does not prevent it from being sold at any price as a secondary sale.

Don’t forget to set the beneficiary address, which is the one that will receive the MANA from your sales. You can use any Ethereum address you like. To automatically fill in the address you are logged in with, click I’m the Beneficiary.

Put the item up for sale and you will be back to the list of wearables in your collection. When you click on the item, you will get its general info. Click on the button Preview to see it on the editor.

The Editor #

Once you click on Preview, you will have the editor open. You can edit all the info of your wearable, as well as add new ones, such as description, tags and overrides. This also where you add other body shape representation to your wearable.

Description #

This is a brief statement describing your item that will be displayed in the marketplace.

Overrides #

Overrides determine which Wearable categories or avatar body parts your item will hide. For instance, a hat with attached hair might need to hide the Hair category. A deep-sea diver helmet may require hiding head accessories like earrings, eyewear, tiaras, etc., which wouldn’t be visible. Multiple options can be selected for each override.

  • Base Body: This refers to core avatar parts like the head and hands. For example, if you’re creating a Handwear item such as a robot mechanic hand, you’ll likely need to hide hands to prevent overlap and clipping.

  • Wearables: This includes other Wearable categories. You can hide multiple categories. For more details on each category and how items interact, refer to Creating Wearables .

Note: The overrides you select will be the suggested default settings for your Wearable. However, users can customize which Wearables are hidden or showing from the Backpack.

Tags #

Tags are simply descriptive words that users can use when searching or filtering for items. These are relevant to competitions or events!

VRM Export Permission #

When this property is enabled, it will allow owners of your item to include it in VRM Avatar Exports so they can show it off outside of Decentraland.

Adding Another Representation #

If your wearable has a different representation for male and female you will need to upload another file. So far, you only have one uploaded. In the example, it was the female version of the Krampus Sweater. To add the other representation, click on the three dots () at the top right, next to Properties and select Add male/female representation. In the example below, we needed the male version.

Once you click on it, you will get the Add Male/Female representation window, drag and drop the other representation file to upload it. Once uploaded, another window will show up the wearable and if everything is ok, just click on Save.

Preview #

To preview your wearable, hover your mouse over the wearable icon on the top left and click on the eye symbol.

By clicking on the icon at the lower left you will be able to edit the avatar. This is pretty useful if you have a male and female version of your wearable, so make sure to check how both versions look like in editor, testing different emotes to identify if there are any skinning issues and mixing other wearables to see how it matches with different clothes. When you’re done editing your wearable, click on Save.

Testing in World #

Even after testing the wearable in the editor, it’s important to check how it’s actually going to look like and behave in Decentraland. To test it in world, go to the Collections tab. Select the desired collection and click the button See in World.

After clicking the following pop up is going to appear. Selecting Empty Parcels will teleport you to a place without too much content, which will load faster. Selecting Genesis Plaza will take you to the main plaza.

Once you select the location to teleport, a new tab will open on your browser and you will get this message.

Click on Switch to Sepolia and a popup from your wallet will show up asking to switch the network. Simply click on Switch Network and the new tab will automatically refresh. To test your wearable, go to the backpack and select it.

Before Publishing #

Make sure to set the price properly, add a nice description and double check if all the information and settings are right. If you’ve filled all the information necessary you will see Done as the status of your item.