# Media metadata

Metadata consists of relevant data for each token, including its attributes and its number of attributes ([OpenRarity protocol](https://www.openrarity.dev/)). It's important to note that deploying a collection on a chain does not require metadata, although it can enhance the token's information and value.

Depending on the type of collection, metadata can be set automatically or manually. Here are the differences:

### "**Editions**" and "**Drops**" collections

At this type of project, users must manually set the metadata attributes for their artworks. Regardless of the collection type, you can specify the metadata for each token individually. This means you can specify metadata for each token individually or apply standard metadata to all tokens.

In "Editions" collections, the number of NFTs created with the same media depends on the collection size. However, you can specify metadata separately for each token.

Let's review the different steps and options:

1. Firstly, we will encounter an "edit metadata" button after adding media. Below, we can observe this in both the "Editions" and "Drops" collection types:

<figure><img src="/files/CHZ0oVNKjFLT8pIP4sp4" alt=""><figcaption><p>Editions edit metadata option</p></figcaption></figure>

<figure><img src="/files/ALvLOCwXX26vh2WykoTi" alt=""><figcaption><p>Drops edit metadata option</p></figcaption></figure>

Then, a modal is displayed where you can simultaneously set the metadata for either one or all tokens. Within the modal, there are two fields. The first is for the trait name you are assigning, and the second is for the trait value.

<figure><img src="/files/do5m3weaBfKrwFBmWnYB" alt=""><figcaption></figcaption></figure>

To set the same metadata trait for all tokens, select the "All tokens" option and then click on the "Add trait All tokens" button.

<figure><img src="/files/91HQJGkShkcsLy4MOQ79" alt=""><figcaption></figcaption></figure>

Once you do that, you will see that the trait is added to all tokens in the collection.

<figure><img src="/files/7zir52m1ly25ErUvcwfu" alt=""><figcaption></figcaption></figure>

If you need to delete a metadata attribute, you can do so by hovering your mouse over it and then clicking on the "DELETE" option that appears.

<figure><img src="/files/lueQtxw4X9tR0ROXjEzz" alt=""><figcaption></figcaption></figure>

On the other hand, you can add a metadata attribute to a specific token. Fill in the metadata attribute fields and then select the token ID. Then, an "Add trait Token #" button is shown; you need to click on it to add that attribute. That trait is only added to the specified token (#2 in this example).

<figure><img src="/files/KVFBprljQA3JKN87lg57" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OL6pPfdv0x8LUWGVSU6S" alt=""><figcaption><p>Add metadata attribute to only one token</p></figcaption></figure>

Once the collection is deployed, the token detail modal will display the tokens' metadata attributes. Click on a token to display the detailed model.

<figure><img src="/files/LDZ2LzfdHzSbaEYaYNYV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5D45e01XHbRoIAU8eqQC" alt=""><figcaption></figcaption></figure>

### Save collection metadata

Before deploying the collection, you can save the metadata as a .zip file. This allows you to deploy new similar collections with the same metadata or use it as a template for new collections. Furthermore, it serves as a backup for future disasters.

Click on the "Backup" button, and a zip file with the collection metadata will be downloaded:

<figure><img src="/files/l2HqPw0sN3xc4SxzwS6K" alt=""><figcaption></figcaption></figure>

Then, if you open the zip file, you will see a JSON file for each token. The file name corresponds to the token's identifier.

<figure><img src="/files/jbMGFUPjmJFfaG9cU8YD" alt=""><figcaption></figcaption></figure>

If you open a token file, you will see metadata attributes for that specific token.

<figure><img src="/files/xRgXmfJphkvEjrt9CJCV" alt=""><figcaption></figcaption></figure>

### How can I restore saved metadata?

As mentioned earlier, you can restore saved metadata to another collection or deploy the same one again. You only have to click the "Restore" button after the artwork has been uploaded. Remember to click the "Edit metadata" button to display the metadata modal.

<figure><img src="/files/daTeBWB1BZCY7j42BCK3" alt=""><figcaption></figcaption></figure>

An advertisement dialog will be displayed to inform you that all metadata will be replaced.

<figure><img src="/files/6bvzEB0w4aNmPEiF6Jzq" alt=""><figcaption></figcaption></figure>

### "**Generative Art**" collections

In this type of project, we automatically generate the metadata for you, offering individual editing if necessary.

The tool automatically generates a trait for each layer, setting the value defined by the layer and determining the trait's rarity.

<div data-full-width="true"><figure><img src="/files/2X7O5326BKaWVVfVP17v" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/1LJWx0iNJZHMTb0bERTP" alt=""><figcaption><p>Token layers metadata automatically generated</p></figcaption></figure>

### Hide metadata. What's the placeholder?

You can deploy a collection in which the artwork and the metadata are hidden. You can reveal them from the beginning, meaning all metadata will be public, or you can use a placeholder image to conceal it until you decide to reveal it. If you choose to hide it using a placeholder, not only will its image be hidden, but also its name, description, and metadata. Once the information is revealed, it will be fixed on the blockchain, and you won't be able to change it.

The tool provides you with the option to choose for this purpose. If you go to the "Advanced Options" tab, you will see an option called "Placeholder / Reveal Metadata." You can switch between fixed and delayed reveal.

<figure><img src="/files/at6kRhBP50YDVgWSD21s" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/S5dBd7MwWujHtby2Kp8m" alt=""><figcaption></figcaption></figure>

The placeholder is a temporary image and metadata displayed for every NFT in your collection. It serves as a way to hide or delay the actual images during the minting phase. You can choose when to reveal the actual metadata. We don't upload any on-chain information until you decide to do so. However, once uploaded, it can't be changed.

In the example provided, we have set a cat placeholder, as you can see:

<figure><img src="/files/caJ0e7TyEq8AwL5k1rV6" alt=""><figcaption></figcaption></figure>

Then the placeholder image is shown on the minting page:

<figure><img src="/files/fmYuV7QZeMu4xIOLJWee" alt=""><figcaption></figcaption></figure>

If you click on the NFT to show its details, you can see that all information is hidden, and only the placeholder is shown:

<figure><img src="/files/p4nhyx4ztiYF7GnhyvyH" alt=""><figcaption></figcaption></figure>

When you want to reveal both the image and metadata, you only have to go to the "Mint Settings" option on your project dashboard. Scroll down to arrive at the "Metadata/Placeholder" section:

<figure><img src="/files/eSibDhGXu4x3EyedWHoh" alt=""><figcaption></figcaption></figure>

Click the "Reveal Metadata and Fix on Blockchain" button to reveal the information. This action will fix that information on the blockchain associated with your collection contract. You must confirm it in your wallet and wait while the metadata is revealed and fixed to the blockchain.

<figure><img src="/files/ZMySVUM0DUDzB9QXBg2M" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/82gpXSca20JneuXnIsfA" alt=""><figcaption></figcaption></figure>

Once fixed, the section will change its display mode, and you will see a notification confirming that the metadata has been fixed.

<figure><img src="/files/lbpeEfKBbpEXCPVNKk2e" alt=""><figcaption></figcaption></figure>

Finally, the image and metadata are revealed if we open the minting page.

<figure><img src="/files/Tj4J2XQnnni4jRYTYHKw" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2FqX8QrRlHMZvgnO9Kv2" alt=""><figcaption></figcaption></figure>


---

# 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://mintpad.gitbook.io/docs/nft-media-types/media-metadata.md?ask=<question>
```

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.
