Token Metadata
Learn how to add rich metadata to your SPL tokens including images, descriptions, and custom properties.
Token metadata is stored off-chain (IPFS/Arweave) and linked to your token via a metadata URI.
Metadata Structure
SPL token metadata follows the Metaplex standard with the following structure:
{
"name": "My Awesome Token",
"symbol": "MAT",
"description": "A revolutionary token for...",
"image": "https://arweave.net/abc123...",
"external_url": "https://myproject.com",
"attributes": [
{
"trait_type": "Category",
"value": "Utility"
}
],
"properties": {
"files": [
{
"uri": "https://arweave.net/abc123...",
"type": "image/png"
}
],
"category": "image"
}
}Token Images
Image Requirements
- Recommended size: 512x512 pixels
- Format: PNG, JPG, or SVG
- Max file size: 10MB
- Square aspect ratio preferred
- High contrast for wallet display
Hosting Options
- Arweave: Permanent storage (recommended)
- IPFS: Decentralized, needs pinning
- CDN: Fast but centralized
- Direct URL: Simple but less reliable
Avoid using temporary or unreliable image hosts. Your token image should be permanently accessible.
Metadata URI
The metadata URI points to your JSON metadata file. Popular options include:
Arweave
Recommended
Permanent, decentralized storage with one-time payment.
https://arweave.net/abc123...IPFS
Popular
Decentralized storage, requires pinning service for reliability.
ipfs://QmABC123...Best Practices
✓
Use permanent storage
Choose Arweave or properly pinned IPFS for long-term reliability
✓
Optimize images
Compress images while maintaining quality for faster loading
✓
Include external_url
Link to your project website for more information
✗
Don't use temporary hosts
Avoid file sharing services or temporary image hosts