SPL
Documentation

Metadata Program

How token metadata is stored and managed on Solana using the Metaplex Token Metadata program.

Metadata Structure

On-chain Metadata

{
  "name": "My Awesome Token",
  "symbol": "MAT",
  "uri": "https://example.com/metadata.json",
  "sellerFeeBasisPoints": 0,
  "creators": null
}

Off-chain Metadata (JSON)

{
  "name": "My Awesome Token",
  "symbol": "MAT",
  "description": "A revolutionary token...",
  "image": "https://example.com/image.png",
  "attributes": [],
  "properties": {
    "category": "fungible"
  }
}
Image and Media

Image Requirements

Format
PNG, JPG, GIF, SVG
Size
Recommended: 512x512px
File Size
Max: 10MB

Hosting Options

  • IPFS (Recommended for permanence)
  • Arweave (Permanent storage)
  • Traditional web hosting
  • CDN services
Update Authority

The update authority can modify token metadata after creation, including:

  • Name and symbol
  • Description and image
  • External metadata URI
  • Creator information