Token metadata is the information that describes your Solana token. It includes the name, symbol, logo, description, and other details that wallets, exchanges, and block explorers display to users.
1 What is Token Metadata?
Metadata is the human-readable information about your token. While the blockchain stores the technical details (supply, decimals, mint address), metadata provides the context users need to understand what your token represents.
When someone views your token in a wallet or on Solscan, they see the metadata: the name, symbol, and logo you've defined. Without proper metadata, your token appears as a long address with no identifying information.
2 Core Metadata Fields
Standard SPL token metadata includes several essential fields:
3 Extended Metadata
Beyond the basics, you can add extended metadata to provide more context:
Extended metadata helps with discoverability and builds trust. When users see creator information and social links, they can verify the token's legitimacy and connect with your community.
How Metadata is Stored
On-Chain Storage
Metadata stored directly on the blockchain. Permanent but costs more in transaction fees.
Off-Chain with URI
Metadata stored on a server or IPFS, referenced by a URI. More flexible and cost-effective - the most common approach.
Metadata Standards
The Solana ecosystem uses the Metaplex metadata standard. This ensures compatibility across wallets, exchanges, and tools. When you create a token through a reputable platform, it follows this standard automatically.
The metadata JSON file includes fields like name, symbol, description, image URI, and properties. Wallets read this file to display your token correctly. Learn more about token parameters like name, symbol, supply, and decimals that are part of your token's core configuration.
Why Metadata Matters
User Experience
Without metadata, tokens appear as addresses, making them hard to identify.
Trust
Complete metadata with creator info and social links builds credibility.
Discoverability
Exchanges and tracking sites use metadata to categorise and list tokens.
Professionalism
Well-crafted metadata shows you've put thought into your token.
Updating Metadata
Whether you can update metadata depends on your token's update authority. If you revoke the update authority during creation, metadata becomes permanent. This is generally recommended for trust, but it means you cannot change details later.
If you keep update authority, you can modify metadata later. However, this reduces trust because holders know you could change the token's identity. Learn more about authority management.
Best Practices
When creating token metadata:
