Solana SPL Token Metadata Explained
Introduction
SPL token metadata is the information that tells wallets, explorers, and users how your Solana token should appear. It helps identify your token by displaying details such as its name, symbol, logo, description, and links.
Without metadata, a token may still exist on-chain, but it may appear incomplete or unclear inside wallets and blockchain explorers.
What Is Token Metadata?
Token metadata is a set of information attached to a token mint. This information gives the token a recognizable identity.
Common token metadata includes:
- Token name
- Token symbol
- Token logo
- Description
- Website link
- Social media links
For example, a token named Example Coin might use the symbol EXMP, a logo image, and a short description explaining what the token represents.
Why Metadata Matters
Metadata helps users recognize your token and distinguish it from other tokens with similar names or symbols.
Good metadata can make your token look more professional and trustworthy. Poor or missing metadata can make your token look unfinished.
Token metadata helps display:
- The correct token name
- The correct ticker symbol
- A visible logo image
- A project description
- Official website and social links
Where Is Metadata Stored?
Solana token metadata is usually connected to the token on-chain, while larger files such as logos and metadata JSON files are commonly stored off-chain.
This is because storing large images or detailed metadata directly on-chain would be inefficient and expensive.
Instead, projects commonly use IPFS to store token images and metadata files. The token then stores a reference to that metadata.
What Is a Metadata JSON File?
A metadata JSON file is a structured file that contains the information wallets and explorers use to display your token.
A simple metadata JSON file may include fields such as:
- Name
- Symbol
- Description
- Image URL
- External website URL
When a wallet loads your token, it can read this metadata and display your token's logo, name, and other information.
Token Name
The token name is the full display name of your token.
Examples:
- Solana
- Bonk
- Example Coin
Your token name should be clear, recognizable, and spelled correctly before you create your token.
Token Symbol
The token symbol is the shorter ticker-style label used to represent your token.
Examples:
- SOL
- BONK
- EXMP
Symbols are usually short, easy to read, and written in uppercase letters.
Token Logo
The token logo is the image that appears next to your token in supported wallets, explorers, and DeFi platforms.
A good token logo should be simple, clear, and easy to recognize at small sizes.
Recommended logo tips:
- Use a square image
- Use a clean design
- Avoid tiny unreadable text
- Make sure you have permission to use the image
- Double-check that the file uploads correctly
If using Solana Token Forge, be sure the logo image is no larger than 500x500 px.
Description and Links
Your metadata can also include a project description and optional links.
These links may include:
- Project website
- X / Twitter profile
- Telegram group
- Discord server
- Other official social links
Only include links that are official and safe. Incorrect links can confuse users or make the token look suspicious.
How Solana Token Forge Handles Metadata
Solana Token Forge helps create and attach metadata when you create your token.
The tool collects your token name, symbol, image, description, and optional links, then formats that information into token metadata.
Solana Token Forge uses IPFS storage through Pinata to upload token images and metadata files. This allows your token information to be accessed by supported wallets and blockchain explorers.
Metadata and Update Authority
Update Authority determines whether your token metadata can be changed after creation.
If Update Authority is kept, metadata may be updated later. This can be useful if you need to fix a typo, update a logo, or change a project link.
If Update Authority is revoked, the metadata becomes permanently locked.
- Update Authority kept: metadata can be updated later
- Update Authority revoked: metadata cannot be changed
- Best practice: review metadata carefully before revoking
Common Metadata Mistakes
Metadata mistakes are common when launching a new token, especially when creators rush through the setup process.
Common mistakes include:
- Misspelled token name
- Incorrect token symbol
- Wrong logo image
- Broken website link
- Broken social media link
- Missing description
These mistakes may be fixable if Update Authority is still retained. If Update Authority has been revoked, they may be permanent.
Final Thoughts
SPL token metadata is what gives your token its identity. It controls how your token appears to users across wallets, explorers, and DeFi tools.
Before creating your token, make sure your name, symbol, logo, description, and links are accurate. Once metadata is uploaded and Update Authority is revoked, changes may no longer be possible.
Solana Token Forge simplifies this process by helping you create, upload, and attach token metadata using IPFS storage through Pinata.