Search
K
🌊

Metadata Basics

NFT Metadata

NFT Metadata is represented as JSON objects which are made public. There are two types of metadata used by crypto contracts:
  • Contract: Holds information about the contract/collection
  • Token: Holds information about an individual token

Contract Metadata

Contract metadata tells marketplaces such as OpenSea about your collection including it's name, description and image. The following is an example of contract metadata:
{
"name": "Enlightenment V4",
"description": "This collection was created as a demo to showcase the HyperMint app and client sdk. All information for this page is coming from the network via the sdk to show what is possible.",
"image": "https://demo.hypermint.com/nfts/images/logo.jpg",
"external_url": "https://hypermint.com",
"seller_fee_basis_points": 100,
"fee_recipient": "0x894BEE1735cCd4AbC811e30645cd981938B39f18"
}
Where
  • name is the name of the collection
  • description gives information about the collection
  • image is the main image shown on marketplaces
  • external_url links to your collection website
  • seller_fee_basis_points the percentage that will be paid on secondary sales (should match your account page)
  • fee_recipient where the secondary sales fees will be paid (should match the secondary sales wallet on your account page)
Here's an example of how this metadata shows up on OpenSea.

Token Metadata

Token metadata describes an individual token. It contains similar properties to contract metadata as well as configurable attributes. The following is an example of token metadata:
{
"name": "Party Time",
"description": "The lamps decided to have a party...it was pretty lit",
"image": "https://demo.hypermint.com/nfts/images/3.jpg",
"external_url": "https://hypermint.com"
}
Where
  • name is the name of the token
  • description gives information about the token
  • image is the main image shown on marketplaces
  • external_url links to more information about your token
As well as the above, additional properties such as attributes and multi-media files can be associated with the token. More information can be found here: https://docs.opensea.io/docs/metadata-standards

Feedback

Something not quite right, unclear or can't find what you are looking for? Please let us know at [email protected] and we will get back to you as soon as we can.