Skip to main content

CIP-25

The convention that tells wallets and marketplaces how to read an NFT's name, image, and attributes from the metadata attached when the token was minted.

CIP-25 places a JSON document in the minting transaction's metadata under the label 721, keyed by the token's policy id and asset name. The document carries a name, an image (usually an ipfs:// link), an optional mediaType, and any number of custom attributes. Because the data is written at mint time as transaction metadata, it is cheap and simple, and it became the de facto way NFTs are described on Cardano.

The trade-off is that the metadata is effectively frozen: it can only change if the policy stays open and the token is re-minted, which most collections deliberately prevent by time-locking the policy. When a project needs metadata that a smart contract can read on-chain or update over time, CIP-68 is the newer alternative that stores the data in a datum instead of in transaction metadata.

Sources

Explore next