Beginner guide
What is Token Metadata?
Learn what Token Metadata is on Solana, what information it stores, and why wallets use it to display your token.
On this page
What is Token Metadata?
Additional information attached to an SPL Token, such as its name, symbol, logo and external links.
The Mint Account only stores technical information about a token. Human-readable information is stored separately inside a Metadata Account.
Why is Token Metadata important?
Without metadata, wallets would only display the token address.
Metadata allows wallets and explorers to display a token name, symbol and logo.
It improves readability and helps users recognize legitimate tokens.
What information does Metadata contain?
| Field | Example |
|---|---|
| Token name | My Token |
| Symbol | MTK |
| Logo | Image URI |
| Description | Project description |
| Website | https://... |
| Social links | X, Telegram, Discord |
Mint Account vs Metadata Account
The Mint Account defines how the token works. The Metadata Account defines how the token is presented to users.
How wallets use Metadata
Wallets such as Phantom automatically read the Metadata Account when displaying tokens.
If no metadata exists, the wallet usually displays only the token address.
How Token Creator uploads Metadata
When you create a token with Token Creator, your logo and metadata are uploaded to IPFS before the Metadata Account is created on-chain.
💡 Good practice
Use a square logo with a high resolution to ensure it looks good across wallets and explorers.
Typical workflow
Prepare a square image.
Store the image and metadata.
Register the metadata on-chain.
Wallets automatically display your token.
Frequently Asked Questions
Does Token Metadata store the token supply?
No. The token supply is stored in the Mint Account.
Can I add a logo after creating my token?
Yes, as long as the metadata remains updateable.
Where is the logo stored?
Usually on IPFS, with its URI referenced by the Metadata Account.
Which wallets use Token Metadata?
Most Solana wallets and explorers automatically read it.
Ready to launch your own token?
Create an SPL token directly on Solana in less than a minute. No coding. No custody. Everything happens on-chain from your wallet.
Create your token →Continue reading
What is an SPL Token? A Beginner's Guide to Solana Tokens
Learn what an SPL Token is, how it works, what information it contains, and how it differs from Ethereum's ERC-20 standard.
What is a Token Account?
Learn what a Token Account is on Solana, why every wallet needs one, and how it differs from the Mint Account.
What is Mint Authority?
Learn what mint authority is on Solana, why it matters for your token, and when you should revoke it.