Metadata in the context of NFTs includes essential information such as the name, description, and media (e.g., images, videos) associated with the asset. This metadata must be stored somewhere to be accessible and verifiable on the blockchain.

​
Crossmint Metadata Storage

Crossmint automatically uploads and validates metadata for you, ensuring a seamless minting experience. Both metadata and media files are stored on decentralized storage solutions.

​
Supported Storage Providers

Crossmint supports two primary storage providers:
  • IPFS (InterPlanetary File System) (Default): A widely adopted decentralized storage standard ensuring compatibility across blockchain ecosystems by enabling peer-to-peer file storage and retrieval.
  • Walrus Network: A new decentralized storage solution designed for efficient and scalable metadata hosting.
    • Walrus is currently not supported for EVM NFT templates.
If you are interested in using Arweave for metadata storage, please contact us for further information.

​
Configuring Storage

By default, Crossmint uses IPFS to store metadata and media. However, if you prefer to use Walrus, you can configure this in the Crossmint Console under Settings > General. Storage Providers
If you prefer to upload and manage media files independently, you can pass a direct URL to the Mint API and set the reuploadLinkedFiles flag to false. This prevents Crossmint from automatically reuploading media files to decentralized storage.

​
Metadata Standards

Collection and NFT metadata (e.g. title, description, image) must be specified in JSON format and follow industry conventions to ensure it renders appropriately across wallets and marketplaces. Crossmint supports rich metadata like audio, video, and HTML. To include rich metadata, simply populate animation_url as specified in the links below.

File size limits

Crossmint has two different size limits: - Metadata JSON object: Maximum 5KB size for the metadata JSON object itself - Media files: Maximum 10MB size for individual files referenced in the metadata For larger uploads, you must upgrade to a premium plan or handle the upload yourself.
Metadata standards differ slightly across blockchains:
EVM chains follow the OpenSea standard. Refer to their official documentation to see what attributes can be included and how. Note that name and image are mandatory fields.
EVM Metadata Example
{
  "name": "Crossmint Test NFT",
  "description": "Created with the Crossmint minting API",
  "image": "https://bafkreiexjl6kw4khdxkrt6dojgacscnzvrys47t472l2t7d6r2ss65kifq.ipfs.nftstorage.link/",
  "external_url": "https://docs.crossmint.com",
  "attributes":  [
    {
      "trait_type": "background",
      "value": "black"
    },
    {
      "trait_type": "flavor",
      "value": "minty"
    }
  ]
}

​
FAQs

​
Troubleshooting