NFT Metadata Explained | Crossmint Docs

Metadata in the context of NFTs includes essential information such as the name, description, and media (e.g., images, videos) associated with the asset.

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’s standard plan has a 10mb file size limit. 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"
    }
  ]
}

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"
    }
  ]
}

Solana follows the Metaplex Metadata Standard. For more information, refer to the official Metaplex documentation - see the JSON structure section.

Solana Metadata Example

{
  "name": "Crossmint Test NFT",
  "symbol": "XMINT",
  "description": "Created with the Crossmint minting API",
  "seller_fee_basis_points": 5000,
  "image": "https://bafkreiexjl6kw4khdxkrt6dojgacscnzvrys47t472l2t7d6r2ss65kifq.ipfs.nftstorage.link/",
  "attributes": [
    {
      "trait_type": "background",
      "value": "black"
    },
    {
      "trait_type": "flavor",
      "value": "minty"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "https://bafkreiexjl6kw4khdxkrt6dojgacscnzvrys47t472l2t7d6r2ss65kifq.ipfs.nftstorage.link/",
        "type": "image/png"
      }
    ],
    "category": "image",
    "creators": [
      {
        "address": "xm2Mc3HEd2bGJXeqJEBrek4bj79gxzYkBaEobnpFraH",
        "share": 100
      }
    ]
  }
}

Aptos follows the Aptos Legacy Token Standard. For more information, refer to the official Aptos Documentation - see the JSON structure section.

Aptos Metadata Example

{
  "name": "Crossmint Test NFT",
  "description": "Aptos Attributes Test",
  "image": "https://www.arweave.net/abcd5678?ext=png",
  "animation_url": "https://www.arweave.net/efgh1234?ext=mp4",
  "external_url": "https://petra.app/",
  "attributes": [
    {
      "trait_type": "web",
      "value": "yes"
    },
    {
      "trait_type": "mobile",
      "value": "yes"
    },
    {
      "trait_type": "extension",
      "value": "yes"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "https://www.arweave.net/abcd5678?ext=png",
        "type": "image/png"
      },
      {
        "uri": "https://watch.videodelivery.net/9876jkl",
        "type": "unknown",
        "cdn": true
      },
      {
        "uri": "https://www.arweave.net/efgh1234?ext=mp4",
        "type": "video/mp4"
      }
    ],
    "category": "video"
  }
}

Crossmint Metadata Storage

Metadata must be stored somewhere to be accessible and verifiable on the blockchain. Crossmint automatically uploads and validates metadata for you on decentralized storage solutions, ensuring a seamless minting experience.

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.

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.

FAQs

What type of files can I store?

What's the maximum file size?

Can I store the metadata on a centralized server?

On this page

Metadata Standards
Crossmint Metadata Storage
Supported Storage Providers
Configuring Storage
FAQs

Metadata in the context of NFTs includes essential information such as the name, description, and media (e.g., images, videos) associated with the asset.

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’s standard plan has a 10mb file size limit. 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"
    }
  ]
}

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"
    }
  ]
}

Solana follows the Metaplex Metadata Standard. For more information, refer to the official Metaplex documentation - see the JSON structure section.

Solana Metadata Example

{
  "name": "Crossmint Test NFT",
  "symbol": "XMINT",
  "description": "Created with the Crossmint minting API",
  "seller_fee_basis_points": 5000,
  "image": "https://bafkreiexjl6kw4khdxkrt6dojgacscnzvrys47t472l2t7d6r2ss65kifq.ipfs.nftstorage.link/",
  "attributes": [
    {
      "trait_type": "background",
      "value": "black"
    },
    {
      "trait_type": "flavor",
      "value": "minty"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "https://bafkreiexjl6kw4khdxkrt6dojgacscnzvrys47t472l2t7d6r2ss65kifq.ipfs.nftstorage.link/",
        "type": "image/png"
      }
    ],
    "category": "image",
    "creators": [
      {
        "address": "xm2Mc3HEd2bGJXeqJEBrek4bj79gxzYkBaEobnpFraH",
        "share": 100
      }
    ]
  }
}

Aptos follows the Aptos Legacy Token Standard. For more information, refer to the official Aptos Documentation - see the JSON structure section.

Aptos Metadata Example

{
  "name": "Crossmint Test NFT",
  "description": "Aptos Attributes Test",
  "image": "https://www.arweave.net/abcd5678?ext=png",
  "animation_url": "https://www.arweave.net/efgh1234?ext=mp4",
  "external_url": "https://petra.app/",
  "attributes": [
    {
      "trait_type": "web",
      "value": "yes"
    },
    {
      "trait_type": "mobile",
      "value": "yes"
    },
    {
      "trait_type": "extension",
      "value": "yes"
    }
  ],
  "properties": {
    "files": [
      {
        "uri": "https://www.arweave.net/abcd5678?ext=png",
        "type": "image/png"
      },
      {
        "uri": "https://watch.videodelivery.net/9876jkl",
        "type": "unknown",
        "cdn": true
      },
      {
        "uri": "https://www.arweave.net/efgh1234?ext=mp4",
        "type": "video/mp4"
      }
    ],
    "category": "video"
  }
}

Crossmint Metadata Storage

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.

FAQs

What type of files can I store?

What's the maximum file size?

Can I store the metadata on a centralized server?

On this page

Metadata Standards
Crossmint Metadata Storage
Supported Storage Providers
Configuring Storage
FAQs

Define Metadata

Metadata Standards

File size limits

Crossmint Metadata Storage

Supported Storage Providers

Configuring Storage

FAQs

Changelog

Define Metadata

Metadata Standards

File size limits

Crossmint Metadata Storage

Supported Storage Providers

Configuring Storage

FAQs

​Metadata Standards

File size limits

​Crossmint Metadata Storage

​Supported Storage Providers

​Configuring Storage

​FAQs

Changelog

​Metadata Standards

File size limits

​Crossmint Metadata Storage

​Supported Storage Providers

​Configuring Storage

​FAQs

Metadata Standards

Crossmint Metadata Storage

Supported Storage Providers

Configuring Storage

FAQs

Metadata Standards

Crossmint Metadata Storage

Supported Storage Providers

Configuring Storage

FAQs