# Wearables
Wearables are the [entities](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md) that contain items for players to wear and customize their avatars.
The `wearables` field in a player's [profile](https://github.com/decentraland/docs/blob/main/contributor/entity-types/profiles/README.md) contains a list of pointers to the items they are currently wearing.
Every wearable belongs to a *category*, indicating the spot it takes on the avatar's body, and can hide or replace other categories (for example, a long dress may be worn as top clothing but entirely cover the legs).
There are 18 wearable categories, referenced in various metadata fields: `body_shape`, `hair`, `eyes`, `eyebrows`, `facial_hair`, `mouth`, `upper_body`, `lower_body`, `feet`, `hat`, `helmet`, `mask`, `tiara`, `top_head`, `earring`, `eyewear`, `skin` and `hands_wear`.
Wearable entities include files in GLB format for different body shapes.
### Pointers
Wearables have exactly one associated [pointer](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md), which indicates the [collection](https://github.com/decentraland/docs/blob/main/contributor/entity-types/collections/README.md) they belong to and their identifier inside of it.
When the wearable is an on-chain asset, the pointer is a URN of this form:
```
urn:decentraland::collections-v2::-
```
To illustrate, the `pointers` array for an on-chain wearable looks like this:
```json
{
"pointers": [
"urn:decentraland:matic:collections-v2:0x2d9560df9dd8ba8b2dc3746bc1d217698d258fb5:0"
],
// ... other entity properties
}
```
When the wearable is an off-chain asset, such as the default wearables for new avatars, it will be of this form:
```
urn:decentraland:off-chain::
-
```
The collection in this case is a name, not an address, and the item identifier is also a name rather than an index.
The `pointers` array for an off-chain wearable has this look:
```json
{
"pointers": [
"urn:decentraland:off-chain:base-avatars:BaseFemale"
],
// ... other entity properties
}
```
### Metadata Fields
Wearables share most of their basic fields with [emotes](https://github.com/decentraland/docs/blob/main/contributor/entity-types/emotes/README.md). The `data` property is where the wearable-specific information is located.
| Field | Value |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | The [pointer](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) that resolves (or used to resolve) to this wearable. |
| `name` | The display title for this wearable in a [collection](https://github.com/decentraland/docs/blob/main/contributor/collections/README.md). |
| `description` | An extended description for this wearable. |
| `image` | The [internal filename](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) of a picture for this wearable. |
| `thumbnail` | The [internal filename](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#files) of a 256x256 version of the `image`. |
| `rarity` | One of `common`, `uncommon`, `rare`, `epic`, `legendary`, `exotic`, `mythic` or `unique`. |
| `i18n` | An array of translations for the `name` field. |
| `collectionAddress` | The Ethereum address for the collection that contains this wearable. |
| `metrics` | Some useful measurements about the animations (see below). |
| `data` | The extended metadata for this wearable (see below). |
In typical JSON form:
```json
{
"id": "urn:decentraland:matic:collections-v2:0x11a6879861f36cbad632b4e7226816a16139fb33:0",
"name": "Pretty Dress",
"description": "Very nice to wear",
"image": "image.png",
"thumbnail": "thumbnail.png",
"rarity": "uncommon",
"i18n": [
{ "code": "es", "text": "Vestido Lindo" }
],
"collectionAddress": "0x11a6879861f36cbad632b4e7226816a16139fb33",
"metrics": {
// Measurements object (see below).
},
"data": {
// Extended metadata (see below).
}
}
```
### Metrics
In the `metadata.metrics` object, you'll find some simple measurements for the models packaged with this wearable. An example:
```json
{
"entities": 1,
"bodies": 12,
"materials": 2,
"meshes": 12,
"textures": 2,
"triangles": 3321
}
```
### Data
The `metadata.data` object is where the wearable-specific properties are located.
| Field | Value |
| ----------------- | ------------------------------------------------------------------ |
| `category` | One of the wearable categories listed above. |
| `representations` | An array of files associated to different body shapes (see below). |
| `hides` | An array of categories this wearable hides. |
| `replaces` | An array of categories this wearable replaces entirely. |
| `tags` | An array of string labels descriptive of this wearable. |
#### Representations
Each item in the representations array associates a body shape with a collection of models, and can add rules regarding which wearables are displayed in each category.
| Field | Value |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `bodyShapes` | An array of [pointers](https://github.com/decentraland/docs/blob/main/contributor/pointers/README.md) to body shape entities. |
| `mainFile` | The 3D model file to start the rendering. |
| `contents` | An array of filenames (present in the top-level [`content` field](https://github.com/decentraland/docs/blob/main/contributor/entities/README.md#properties)) used by the `mainFile`. |
| `overrideHides` | Supersedes the `hides` list above for this representation. |
| `overrideReplaces` | Supersedes the `replaces` list above for this representation. |
This is a typical `representations` item:
```json
{
"bodyShapes": [
"urn:decentraland:off-chain:base-avatars:BaseFemale"
],
"mainFile": "male/190.glb",
"contents": [
"male/190.glb"
],
"overrideHides": [ "lower_body" ],
"overrideReplaces": []
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.decentraland.org/contributor/content/entity-types/wearables.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.