Metadata

Metadata simply put is a bundle of data that contains all the "content" for each NFT within your collection. Metadata is what assigns an NFT its name, media (image, video, audio, etc.), and traits where relevant.

If you're using the Scatter Uploader, you can generate basic metadata automatically and edit traits in the UI. This page is still the reference for fields and structure for those who want to generate or upload their own custom metadata.

Scatter's Metadata Standard

Below are the principle metadata fields Scatter supports. You can add more if you'd like, but the table below covers everything that is required.

Sometimes whatever tool you use to generate your JSONs adds extra unnecessary fields that bloat your JSONs and make them ugly. You can adapt one of these Python scripts to loop through all of your JSON files and update them to clean away the bloat:

https://github.com/Scatter-Partners/useful-scripts/tree/master/cleaning ↗

Or use this webtool version:

https://webtools.scatter.art/clean-jsons/ ↗

Extra files such as _metadata.json can also be deleted safely from your JSON folder if that is generated.

If you are on macOS you can avoid including the system files (such as .DS_Store and __MACOSX folder) in the zip you are uploading by running this command in the folder of the "json" and "images" folders:

zip -r yourcollectionname.zip . -x '**/.*' -x '**/__MACOSX'

If you are using Instareveal you cannot include these extra generated / system files when you upload your zip containing the "images" and "json" folder.

If you are hand making the JSON files or making your own script make sure you use double quotes " and not single quotes ' as JSON expects only double quotes to be used in JSON files.

Attributes

Attributes or traits are a way to define the unique aspects of each NFT within your collection, while also adding an element of collectibility based on varying trait rarities. Typically, you would have an assortment of traits ranging from extremely rare to very common. You want enough variety in your common traits for your collection to not look too 'samey'. At the same time, generally you want to create some feeling of uniformity so that your collection feels like a unified set, assuming that's the intention.

Scatter uses OpenRarity for calculating trait rarity rankings.

Sometimes you want to force some NFTs (such as 1/1s) to have higher rarities in your collection. You can achieve this by stuffing every trait_trait type possible with a unique string that is not listed in any other NFT. The following is an example of this where each trait_type is stuffed with a unique string to ensure it has a high rarity within the collection as a 1/1: https://www.scatter.art/collection/oekaki-maker/gallery/nfts/498 ↗

JSON Example

The below is the JSON of this NFT: https://www.scatter.art/collection/oekaki-maker/gallery/nfts/4272 ↗

{
  "name": "Oekaki #4272",
  "description": "Neo-chibi aesthetic enthusiast network cohesion lainpilled artisanal AI generative synthesis NFTS",
  "external_url": "https://www.oekakimaker.net/",
  "image": "ipfs://bafybeic5yxtsyokpmlkzqyxx7rtyvm7apmkm52byjh6fqu5wm45kpvelem/4272.png",
  "attributes": [
    {
      "trait_type": "Name",
      "value": "Taruho"
    },
    {
      "trait_type": "Background",
      "value": "Toshokan"
    },
    {
      "trait_type": "Skin",
      "value": "Tan"
    },
    {
      "trait_type": "Outfit",
      "value": "Black Lolita Dress"
    },
    {
      "trait_type": "Mouth",
      "value": "Cutie Fanged"
    },
    {
      "trait_type": "Eyes",
      "value": "Simply Blue"
    },
    {
      "trait_type": "Hair",
      "value": "Kitten"
    },
    {
      "trait_type": "Headwear",
      "value": "Maid Headdress"
    },
    {
      "trait_type": "Core",
      "value": "Otaku-Dark"
    }
  ]
}