# Preparing your Traits

## Preparing and Uploading your Traits

The traits are the individual images that make up the layers of the final images in your collection. The traits are separated into groups, called 'trait types'. Typically, each image in your collection is made up of one trait from each trait type (however, this doesn't have to be the case).&#x20;

For example, your traits may be split into the following types: 'Background', 'Clothing', 'Head' and 'Expression', etc.

{% hint style="info" %}
All traits must be one of the following file formats: WEBP, JPEG, PNG, APNG, AVIF, GIF and SVG.

However, we recommend using WEBP or SVG, as these typically result in the smallest file sizes, resulting in lower inscription costs.

Animated images, such as GIF's or APNG's will not animate properly, so we do not recommend using them.&#x20;

However, animated images **can** be used for 1/1's (items with only one trait) and they will animate properly.
{% endhint %}

Before uploading your traits, you should sort them into folders based on trait type. Below is an example of how to organise the traits. The names of the folders (Background, Clothing, Expression and Head) are the names of the trait types, while the names of the images are the names of the traits (Bats, Charcoal, Doodle Dark, etc.). The names of the folders and files are important, since GeneratOrd uses these to name your trait types and traits, which will also then appear on market places.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FhXcNxtmU79qx36b0Ttuo%2Ffolder%20structure.png?alt=media&#x26;token=d44cc3fd-9dbf-419d-a145-b788a98e3d59" alt="" width="349"><figcaption><p>Example of how you should organise your traits before uploading to GeneratOrd</p></figcaption></figure>

To upload your traits to GeneratOrd, navigate to the Traits Tab, and drag and drop the folder containing all your traits into the labeled section. You can also click the **Add Traits > Upload Folder** button as shown below. This will allow you to select a folder from your file system.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FxjcKsjad9vvUkTfCPdBr%2Fupload%20folder.png?alt=media&#x26;token=66b69583-d937-47c1-a339-586e31d100d3" alt=""><figcaption><p>Upload your traits by dragging and dropping them, or clicking Add Traits > Upload Folder to select the folder from the file system</p></figcaption></figure>

GeneratOrd will automatically group your traits into trait types, and will name the trait types and traits based on your folder/file names. Below is the result of uploading the folder structure shown above.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FrLmjcJEtHmVGCWKXrvyP%2Ftraits%20example.png?alt=media&#x26;token=0d4e654d-6ef3-47c4-8de1-af7745a95b75" alt=""><figcaption><p>Screenshot showing how the traits are organised into trait types in GeneratOrd</p></figcaption></figure>

## Other ways to add your Traits

### Uploading Images

You can add a new trait type by clicking **Add Trait Type**. This will add an empty trait type with a default name of **Untitled Trait Type**, so you will need to rename it which can be done by clicking on the name and typing in a new name.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FFpJC3LTOkksIl8V5xShG%2Fadd%20trait%20type.png?alt=media&#x26;token=9cce279d-22e1-408e-b5ae-91d9bc457882" alt=""><figcaption><p>Click <strong>Add Trait Type</strong> to add a new, empty trait type</p></figcaption></figure>

Traits can then be added to the trait type by dragging and dropping images onto the trait type, or clicking the **Add > Upload Images** button located to the right of the trait type you want to add traits to.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FIOwOdh5VVmoVyIvenWfP%2Fadd%20images%20to%20trait%20type.png?alt=media&#x26;token=f5189617-408e-45c0-8e11-2762f325dcee" alt=""><figcaption><p>Click <strong>Add > Upload Images</strong> to upload images to a given trait type. You can also Drag and drop images anywhere in the trait type. </p></figcaption></figure>

### Adding Preinscribed Traits

#### Add Inscription ID's Manually

To add inscription ID's manually, click the **Add > Add Inscription ID's** button located to the right of the trait type you want to add traits to. In the example below, we are adding traits to the **Background** trait type.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FQ1MNOpWqwhU2M3fjkekn%2Fadd%20inscription%20ids%20to%20trait%20type.png?alt=media&#x26;token=4f594a3e-67c6-41e4-9bf5-ee79a20a48ff" alt=""><figcaption><p>Add Inscription ID's by clicking <strong>Add > Add Inscription ID's</strong> on the header of the trait type you want to add traits to</p></figcaption></figure>

This will open a dialog window as shown below. Enter the name and Inscription ID for each of the traits you're adding. You can add as many or as few traits as you wish. To add extra rows, click the **Add New** button, allowing you to enter in more traits. Alternatively, you can click the **Delete** buttons on the right to remove a trait. When you're done, click the **Add** button to add them to the trait type.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FrChxS4xZjuF2JK4qi9qC%2Fadd%20inscription%20ids%20modal.png?alt=media&#x26;token=0b4bc4cf-4747-4a18-96e5-95bf69cfacdb" alt="" width="512"><figcaption><p>Add Inscription ID's dialog, allowing you to add the inscription ID's of your traits</p></figcaption></figure>

#### Upload ID's in a JSON File

Adding inscription ID's one by one through the UI can be tedious. To make this easier, we also allow you to upload all your trait ID's at once, in a JSON file. This file has the following format:

```json
{
  "<trait_type>": {
    "<trait_name>": "<inscription_id>",
    "<trait_name>": "<inscription_id>",
    ...
  },
  "<trait_type>": {
    "<trait_name>": "<inscription_id>",
    "<trait_name>": "<inscription_id>",
    ...
  },
  ...
}
```

{% hint style="info" %}
Here is a completed example of the [traits JSON file](https://76m5dlfsiafsjqyy.public.blob.vercel-storage.com/docs-files/traits.json) (Note: the ID's in this example are not real).
{% endhint %}

To upload this file, click **Add Traits > Upload Inscription ID's** in the top right.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FzkEzCdNA9Ww37hBg32H1%2Fupload%20inscription%20ids%20json.png?alt=media&#x26;token=4547a409-7960-4c66-a035-a4931a7d7596" alt=""><figcaption><p>Click the <strong>Add Traits > Upload Inscription ID's</strong> button in the top right to upload a JSON file containing the inscription ID's of your traits</p></figcaption></figure>

## Editing your Traits

### Renaming and Deleting Trait Types

Trait types can be renamed by clicking on the name of the trait type, or by clicking the **More Actions > Rename** button. Under the **More Actions** menu, you can also delete the trait type. Be careful though, deleting a trait type will also delete all the traits within that group. The **More Actions** menu can be found to the right of the trait type, the button with the 3 dots (**⋮**) as highlighted below.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FnbXFFDlNgRAUllqktvDJ%2Fmore%20actions%20trait%20type.png?alt=media&#x26;token=3fa8d586-a70a-49f2-b769-39a206409cf0" alt=""><figcaption><p>The <strong>More Actions</strong> menu on each trait type allows you to rename or delete the trait type</p></figcaption></figure>

### Renaming and Deleting Traits

Similar to the above, each trait has a **More Actions** menu indicated by the button with 3 dots (**⋮**) next to the trait name as highlighted below. Within this menu, you can rename and delete the trait.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2F58dHWKlLwfW3ccxM8tka%2Ftrait%20more%20actions.png?alt=media&#x26;token=16137e3d-d1ce-4aed-8f1b-af6c518f09f9" alt=""><figcaption><p>The <strong>More Actions</strong> menu of each trait allows you to Rename or Delete the trait</p></figcaption></figure>

### Replacing the Image for a Trait

If you edit the image for a trait after it is uploaded, you can simply replace the image by clicking **More Actions > Replace Image** on the trait you want to replace. The **More Actions** button is the button with 3 dots (**⋮**) next to the trait name as highlighted below.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2FtLDL2U5hwa4wcNN9l0lf%2Freplace%20image.png?alt=media&#x26;token=e266ecc5-aacc-461a-80fc-0302be8cd4fd" alt=""><figcaption><p>To replace the image for a trait, click <strong>Replace Image</strong> In the <strong>More Actions</strong> menu for the trait</p></figcaption></figure>

You can drag and drop the new image, or click **Choose Image** to select it from your file explorer. Alternatively, if the image is already inscribed, you can enter the Inscription ID instead.

<figure><img src="https://458341126-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrOSnB5vqx0dRfYYD0nUg%2Fuploads%2Fe5WrYNSSAzcrIbK063Q3%2Freplace%20image%20modal.png?alt=media&#x26;token=3a348195-c0de-4ac8-b515-92df7e76d30d" alt=""><figcaption><p>Images can be replaced with a file, or the Inscription ID of an already inscribed image</p></figcaption></figure>
