Metadata

Metadata is the descriptive information attached to an NFT, such as its name, description, image link and traits. It is usually a JSON file located through a token URI, an address that the NFT's smart contract returns for each token.

On Ethereum, the ERC-721 standard includes an optional metadata extension. The contract's tokenURI function returns an address for each token ID, and that address points to a JSON file. ERC-1155 tokens work in a similar way through a uri function. Wallets and marketplaces read this file to show the artwork, name and attributes, rather than a bare contract address and token number.

The token itself lives on the blockchain, but the metadata and the media it describes often do not. They may sit on an ordinary web server, on content-addressed storage networks such as IPFS or Arweave, or be stored entirely on-chain. For example, a token URI might point to a file containing a name like "Example #123", a link to its image, and a list of traits such as background colour and accessories. Marketplaces commonly use those traits to calculate rarity.

A common misconception is that owning an NFT means the image is permanently stored on the blockchain. Often the token holds only a pointer. If the server hosting the file goes offline, or nobody keeps IPFS content pinned, the NFT can appear blank or broken. Some contracts also let the creator change the token URI, so the metadata, including traits buyers relied on, can be altered after purchase. Where the metadata is stored and whether it can be changed largely determine how durable an NFT really is.

Learn more

Related terms