Table of Contents
What Counts as Token Metadata?
A Solana token's identity lives in two places, and updating means touching both:
- The on-chain Metaplex metadata account: stores the token's name, symbol, and a URI pointing to the off-chain JSON. This account is created alongside your mint (CreateMyCoin does this automatically at creation).
- The off-chain JSON file (usually on IPFS): holds the description, the logo image link, and social/website links. Wallets, DexScreener, and explorers fetch this file via the on-chain URI.
So a logo change means: new image on IPFS → new JSON pointing at it → on-chain URI updated to the new JSON. A name or symbol change is directly on-chain. The full structure is covered in SPL metadata best practices.
Who Can Update Metadata? (Update Authority)
Every Metaplex metadata account has an update authority — a wallet address with the exclusive right to modify it. Three states matter:
| State | Can metadata change? | How it reads to buyers |
|---|---|---|
| Update authority = your wallet | Yes, anytime | Normal for active projects; mildly flagged by scanners as "mutable" |
| Update authority = someone else | Only by that wallet | Check this if you used a launch service — you want this authority yourself |
| Metadata immutable (authority removed) | Never again | Strongest trust signal; zero flexibility |
Check your token's state on Solscan: the token's metadata section shows the update authority address and whether the metadata is mutable (see verifying your token on Solscan). Note this is a separate authority from mint and freeze authority — revoking those (the big trust signals) does not lock your metadata.
How Do You Update Metadata, Step by Step?
Step 1 — Prepare the new assets
If the logo or links are changing, upload the new image to IPFS first (Pinata is the common choice), then build the updated metadata JSON — same schema as at creation: name, symbol, description, image, and your links — and pin that JSON to IPFS too. You now have a new URI.
Step 2 — Send the update instruction
With the update-authority wallet connected, apply the change on-chain. Options, in increasing order of technicality:
- A no-code metadata update tool: several Solana token utilities offer an "update metadata" flow — connect the authority wallet, paste the mint address, set the new name/symbol/URI, sign. Fees are small (network cost plus, on some tools, a service fee).
- The Metaplex CLI/SDK: the
metaplextooling (or a short script with@metaplex-foundation/mpl-token-metadata) calls the update instruction directly with your new values. Full control, no third parties.
Step 3 — Verify on-chain
Confirm the transaction, then check Solscan: name, symbol, and URI should show the new values immediately. Fetch the URI in a browser to confirm the JSON and image resolve.
Scam warning: "metadata update" is a favorite phishing pretext. Never enter your seed phrase into any metadata tool — legitimate flows only ever request a wallet signature. And double-check the site URL: fake versions of popular token tools are a standing Solana hazard.
Why Don't Changes Show Up Immediately?
The chain updates instantly; the ecosystem doesn't. Expect propagation lag:
- Wallets and explorers cache aggressively. Phantom and DexScreener may show the old logo for hours to days. IPFS gateways cache too — the old image can persist at the gateway layer even after your URI changes.
- Some platforms use their own token lists. Aggregators like Jupiter maintain token metadata pipelines; a change can require their refresh cycle (or, for some, a manual request) to appear.
- Nothing you can do speeds this up much — announce the change to your community so nobody mistakes the stale logo for a problem.
Should You Keep Metadata Mutable?
Mutable metadata is a mild trade-off, not a scandal:
- Keep it mutable while the project is young — brands evolve, links change, and typos happen. Most active projects retain update authority, and scanners treat "mutable metadata" as informational, not damning (unlike an active mint authority).
- Make it immutable when the identity is final and you want maximum-trust optics — it's one more "can't rug this" checkbox alongside revoked mint authority. Just be certain: immutable means a typo lives forever.
"Get the metadata right at creation and the update question mostly disappears. Five minutes of care on the name, ticker, and logo saves a propagation-lag week later."
FAQ
Can I change my Solana token's name after launch?
Yes, if your wallet still holds the metadata update authority — the name and symbol live in the Metaplex metadata account and can be rewritten with an update instruction. If the metadata was made immutable, no one can ever change it.
How much does updating token metadata cost?
The on-chain update itself is just a normal transaction fee (a fraction of a cent). Add IPFS pinning for a new image/JSON (free tiers usually suffice) and whatever service fee a no-code tool charges, if you use one.
Why does my old logo still show in Phantom?
Caching. Wallets, explorers, and IPFS gateways cache token images aggressively; propagation of a logo change typically takes hours to a few days. Verify the on-chain URI points to the new JSON — if it does, the update worked and the rest is cache expiry.
Is mutable metadata a red flag?
Only mildly. Scanners note it, but most active projects keep update authority for practical reasons. The heavyweight trust signals remain mint authority, freeze authority, and liquidity status — see the security checklist.