Metadata
Understand NFT metadata standards
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.
- Currently supported only in the staging environment. Walrus will be available for production use once the mainnet is released.
- 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.
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.
FAQs
Was this page helpful?