TokenAnvilToken identity guide
SPL token metadata: name, symbol, URI, and logo
A Solana mint address is the unique on-chain identifier for an SPL token. Metadata adds the human-readable layer wallets, explorers, and token interfaces use: a name, symbol, description, image (logo), and the URI that points to that document. Good metadata does not make a token valuable or trustworthy by itself—but missing, broken, or misleading metadata creates immediate confusion for holders and anyone verifying your mint.
TokenAnvil is Solana SPL-only. The creator at app.tokenanvil.store collects identity fields and logo in the same wallet-signed flow as supply and authority settings. Tool fees settle on-chain via Phantom / treasury in SOL or supported stablecoins. Base Mainnet creation is $4.99 (up to $9.99 with both authority add-ons). Devnet practice is free.
Prepare and test token metadata
What belongs in SPL token metadata?
Think of metadata as the display package attached to the mint. The mint account still owns supply, decimals, and authorities; metadata tells software how to present the asset.
| Field | Purpose | Practical rule |
|---|---|---|
| Name | Full public token name | Use the same spelling everywhere. Avoid ticker-only names that collide with unrelated projects. |
| Symbol | Short ticker-style identifier | Keep it brief. Symbols are not uniqueness guarantees on Solana—the mint address is. |
| Description | Explains intended use today | Be factual. Skip price promises, listing claims, and return language. |
| Image / logo | Recognizable visual identity | Square, legible PNG or JPG. Avoid tiny text and marks you do not own. |
| URI | Points to the metadata document | Must load publicly and return valid JSON (or the format your stack expects). Broken URIs travel with the mint. |
| External links | Official web and social profiles | Include only channels the project controls. Impersonation links destroy trust faster than missing ones. |
Metaplex-style basics (founder view)
On Solana, token metadata is commonly associated with the Metaplex Token Metadata program: an on-chain metadata account linked to the mint, plus an off-chain (or arweave/IPFS-hosted) JSON document that holds the richer display fields. Solana’s official token documentation points creators to Metaplex for metadata; the Metaplex Token Metadata docs cover the program and account model in depth.
Mint account
Supply, decimals, mint/freeze authority. The mint address is the canonical ID.
Metadata account
On-chain record tying the mint to name/symbol/URI and update authority rules.
Metadata URI
Public document with description, image URL, and optional project links wallets can fetch.
You do not need to hand-write Metaplex instructions to ship a usable token identity. TokenAnvil packages the identity fields into the creation flow so founders can focus on accurate content and verification instead of wire format.
Why metadata matters for wallets and explorers
Wallets and explorers resolve a mint to a display name, ticker, and icon by reading metadata (and their own caches/indexes). When the URI or image fails, users see a raw address or a broken image—even if the mint and balances are fine. When the name or logo mimics another project, users can be misled; that is why publishing the mint address remains non-negotiable.
Metadata is display, not market structure. It does not create a liquidity pool, DEX listing, wallet homepage placement, legal approval, demand, or market value. Those are separate decisions outside TokenAnvil.
Wallet-signed metadata flow in TokenAnvil
The private key stays in the user’s wallet. TokenAnvil never asks for a seed phrase. The creator collects name, symbol, description, and logo; prepares the metadata URI; and includes the related metadata operation in the wallet-approved creation transactions.
- Connect a supported Solana browser wallet (Phantom and Solflare are primary).
- Choose Devnet to rehearse identity fields for free, or Mainnet when content is final.
- Enter name, symbol, description, and upload a square logo that remains clear at small sizes.
- Review supply, decimals, and optional mint/freeze authority choices in the same session.
- Confirm the TokenAnvil tool fee (on-chain to Phantom / treasury in SOL or supported stablecoins) and the separate network fee in the wallet prompt.
- Approve only the transaction you understand. Save the mint address and signature, then verify the metadata URI and image independently.
Open the creator and add metadata
Prepare a logo that displays cleanly
Start with a square image that stays recognizable at favicon and list sizes. Avoid tiny text, screenshots, transparent details that vanish on dark themes, and copyrighted brand marks you do not own. Compress without blurring; keep an original copy outside any single platform. Broken image URLs in the metadata document are a common reason wallets show a blank or generic icon.
Test metadata before a Mainnet launch
Devnet (practice)
- TokenAnvil tool fee: free
- Rehearse name, symbol, logo, and URI
- Inspect wallet prompts with no Mainnet risk
- Do not share a Devnet mint as a live token
Mainnet (live mint)
- TokenAnvil tool fee: $4.99–$9.99
- Wallet pays Solana network fees in SOL
- Publish the exact mint with official metadata
- Allow wallets/explorers time to refresh caches
- Create a complete test token on Devnet with final-like copy.
- 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 it is public and correct.
- Compare the displayed mint address with the one returned by the transaction.
- Fix 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 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 yourself; then allow outside services time to refresh. Do not assume a blank icon means the mint failed.
Common metadata problems and quick fixes
Most display issues trace back to a handful of avoidable mistakes. Check these on Devnet first, before you pay for a Mainnet mint.
| What you see | Likely cause | What to check |
|---|---|---|
| Generic or blank icon | Image URL is private, broken, or still caching | Open the image URL in a private browser window; confirm it loads publicly |
| Wrong name or symbol | Typo in the form, or an old test mint shared by mistake | Compare the mint address you share with the one returned by your transaction |
| Logo looks blurry or cropped | Non-square or tiny source image | Use a square image that stays readable at small sizes |
| Logo vanishes on dark wallets | Transparent artwork with dark edges | Preview the logo on both light and dark backgrounds |
| Description missing | Field left empty or metadata URI not the final one | Open the metadata URI directly and read the JSON |
Rehearse your metadata free on Devnet
What TokenAnvil charges (metadata included in creation)
| Item | Amount |
|---|---|
| Base tool fee (Mainnet) — includes metadata workflow | $4.99 |
| Mint authority revoke add-on | $2.50 |
| Freeze authority revoke add-on | $2.50 |
| Maximum TokenAnvil fee (both add-ons) | $9.99 |
| Devnet practice | Free (TokenAnvil tool fee) |
| Solana network fees | Paid separately by the connected wallet in SOL; shown before approval. |
Fees cover minting, metadata preparation, and optional authority actions—not liquidity, listings, marketing, or returns. TokenAnvil does not open pools or promise exchange support.
SPL metadata FAQ
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 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.
Is the symbol unique on Solana?
No. Many mints can share similar names or tickers. The mint address is the unique identifier—always publish and verify it.
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. Fees settle on-chain via the connected wallet.
Do I need my own RPC API key in the HTML?
No. TokenAnvil landers and the creator do not embed third-party API keys in page HTML. Use the hosted app; do not paste provider keys into public pages.
Related guides
Ready to ship clean metadata?
Open the app, rehearse name/symbol/logo on Devnet, verify the URI and image, then create on Mainnet when identity and disclosures are final.