# Media metadata

Metadata consists of relevant data for each token, including its attributes and the number of attributes it possesses ([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 have to 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 either specify metadata for each token individually or apply common 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, after adding media, we will encounter an "edit metadata" button. Below, we can observe this in both the "Editions" and "Drops" collection types:

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-e58d3ece006366482f341f39965c5096439a3715%2FeditMetadataEdition1.png?alt=media" alt=""><figcaption><p>Editions edit metadata option</p></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-0bfe96e67a8ebfd554571bc949cab4524fa1ccc4%2FdropEditMetadataOption.png?alt=media" alt=""><figcaption><p>Drops edit metadata option</p></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-da367946ba2d9c03c8f110fc566f63e460ac23c0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-0bf79952d9d566ea50532b6e6eabdc92221b4dc9%2FmetadataAlltokens.png?alt=media" 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-1044cc6357d070ea4c52e85b3ae02c0ca730a973%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

If you need to delete a metadata attribute, it's as simple as hovering the mouse over the attribute and then clicking on the "DELETE" option that appears.

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-5e7e9be669da62ba7770af5f6cdf299f79d12b36%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-97eb1955184aed9ecbc5ff55c0a8754e24b66a4b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-a8dc854fe326bcc8b71fb0c7f0181de5b8f6b624%2FmetadataAddOne.png?alt=media" alt=""><figcaption><p>Add metadata attribute to only one token</p></figcaption></figure>

Once the collection is deployed, tokens' metadata attributes will be displayed in the token detail modal. Click on a token to display that detail modal.

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-2fe6908a8f22d842a8576fe8f03621c9127f3c4a%2FCatsMetadataMintingPage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-915193f24f800173d15aef9ca4397c041d04c30d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Save collection metadata

Before deploying the collection, you can save collection 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.

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-a3efc4a74fcf91a5ea9a61ea2c8aeeb3b199800b%2Fmetadata_backup.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-045a61a415fff07b4548a369516a60343df3a174%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-43b777e936fe0ef28e7253634847d5d6858a2a9b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### How can i restore saved metadata?

As mentioned earlier, you can restore saved metadata to another collection or to deploy the same collection once more. To do that, you only have to click on the "Restore" button after the artwork has been uploaded. Remember to click on the "Edit metadata" button to display the metadata modal.

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-1f33881b5e3693b746be82aa17edad6c8c3e3a2b%2Fmetadata_restore.png?alt=media" alt=""><figcaption></figcaption></figure>

An advertisement dialog will be displayed to ensure that you are aware that all metadata is going to be replaced.

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-98f650523277b8ad3713596cab74564dddf2a67e%2Fimage.png?alt=media" 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 rarity of the trait.

<div data-full-width="true"><figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-9c75c67471a96090ea43195fc0dfd4628eef74e5%2FgenerativeDegensPunks.png?alt=media" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-3ec45bb17528e9a5fbdf9a896df1b417c9d4b3c3%2Ftoken_metadata_layers.png?alt=media" alt=""><figcaption><p>Token layers metadata automatically generated</p></figcaption></figure>

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

You can deploy a collection in which both the artwork and the metadata are hidden. You have the option to 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.

For this purpose, the tool provides you with the option to choose. 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-0769eb4ed34e1a768485620edb24e0fc1267006b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-29a2335cac99d0c8e09238f44dc0671d264e96bb%2Fimage.png?alt=media" 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-0c259c4ec9bbc0b729b95ee689a3397c38ad518f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Then the placeholder image is shown on the minting page:

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-f70ab53dbaddd22de3868c1631a1f5ce7611133d%2Fimage.png?alt=media" 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-624a9ad50b9934af40c78f26c5f9c4ec78b6e646%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

At the moment 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-8e3309ab7b5f146cff6487c70af34ca2af5481be%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-7a9184cdc071917f697f7c423296d6f74296a54e%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-2c648782e0daf46d14e521b6ae6e256c941ca271%2Fimage.png?alt=media" 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="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-11faf70a49f5ca6c02ea7822d8215a23964e2c20%2Fimage%20(168).png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-6dfbe25769db747e747690694a04a6204b0488d9%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3026745716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsfdCMm7uC0GmVAWnxMdG%2Fuploads%2Fgit-blob-627200c8273623900aab2eb02bbc7b90993d6633%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
