TOKEN IDENTITY GUIDE
SPL token metadata: logo, name, symbol, and URI
A Solana mint address is the unique identifier for a token. Metadata adds the human-readable identity that wallets, explorers, and token interfaces can use: a name, symbol, description, image, and project links. Good metadata does not make a token valuable or trustworthy by itself, but missing or broken metadata creates immediate confusion.
What belongs in token metadata?
| Field | Purpose | Practical rule |
|---|---|---|
| Name | Full public token name | Use the same spelling everywhere. |
| Symbol | Short ticker-style identifier | Keep it brief and avoid impersonation. |
| Description | Explains the token's intended use | Be factual; avoid price or return promises. |
| Image | Recognizable visual identity | Use a square, legible PNG or JPG. |
| URI | Points to the metadata document | Verify that it loads publicly and returns valid data. |
| Links | Connect official web and social profiles | Include only channels the project controls. |
How TokenAnvil handles the metadata step
The creator collects the identity fields and logo in the same one-page workflow as supply and authority settings. It generates a metadata URI and includes the related token metadata operation in the wallet-approved creation flow. The private key stays in the wallet; users should still inspect each wallet prompt before signing.
The official Solana token documentation points creators to Metaplex for token metadata. The Metaplex Token Metadata documentation covers the metadata program and account model in detail.
Prepare a logo that will display cleanly
Start with a square image that remains recognizable at small sizes. Avoid tiny text, screenshots, transparent details that disappear on dark backgrounds, and copyrighted brand marks you do not own. Compress the file without making it blurry and keep an original copy outside the platform.
Test metadata before a mainnet launch
- Create a complete test token on Devnet.
- Open the resulting metadata URI directly in a browser.
- Confirm the document contains the intended name, symbol, description, and image URL.
- Open the image URL independently and confirm that it is public.
- Compare the displayed mint address with the one returned by the transaction.
- Correct spelling and artwork before repeating the process on Mainnet.
Why a logo may not appear immediately
Wallets and explorers may cache token information or refresh their indexes on their own schedules. A valid metadata URI and image can therefore exist before every third-party interface displays them. First confirm the URI, image, and mint address; then allow the outside service time to refresh.
Frequently asked questions
Can metadata be changed later?
That depends on the metadata setup and whether update authority is retained. Treat any permanent or immutable option as irreversible and verify the final content before selecting it.
Does metadata create a market or listing?
No. Metadata helps software display an asset. It does not create liquidity, exchange support, demand, or legal approval.
How much does TokenAnvil charge?
Base mainnet token creation is $4.99. Both optional authority protections bring the TokenAnvil total to $9.99. Network costs are separate; Devnet testing is free.
TokenAnvil