Why Is My Solana Token Logo Not Showing?
Find out why a token's logo or name is missing: the URI, the JSON document and the image itself, checked in order.
Common questions
Why is my token's logo not showing in Phantom?
Almost always one of four things, and this tool tells you which. Either the mint has no metadata URI at all, or the URI points somewhere that no longer serves the file, or it returns something that is not a JSON document (very often the image itself by mistake), or the JSON is fine but the image link inside it is broken. The mint being fine is not enough: wallets read a chain of things and any link in it can fail.
I fixed it and it still looks wrong. Is it broken?
Probably not. Wallets and explorers cache metadata on their own schedule, so a corrected token can keep showing the old logo, or none, for minutes after the fix confirms. If this tool says everything checks out, the chain is right and you are waiting on a cache. Different apps will update at different times.
It says it could not fetch the document. Does that mean my token is broken?
No, and this is worth understanding. A browser refuses to tell a page why a cross-origin request failed, so we genuinely cannot tell a missing file from a server that simply does not send a CORS header. Wallets often fetch through their own backends and are not affected by that at all. If the URI opens fine in a new tab, your token is almost certainly fine and we just could not read it from here.
How is the image check different?
It is reliable, where the document fetch is not. Loading an image is not a cross-origin read, so an image that fails to load really did fail. If this tool says the image loads, a wallet will be able to load it too.
The name on-chain and in the document are different. Does it matter?
Yes, more than people expect. Wallets differ over which one they display, so a token whose two names disagree shows up under one name in some apps and another elsewhere, and the owner usually has no idea. Pick one and make them match.
Where should I host the metadata document?
Somewhere that will still exist in two years. IPFS and Arweave are the right answers and this tool treats them as good rather than merely acceptable, because they cannot quietly vanish the way a personal web host can. A URL on a domain you might stop renewing is how a token ends up with no logo eighteen months later.
Can I fix the metadata from here?
No, this page only diagnoses. Changing the name, symbol or URI is done with Update Metadata, and it needs the update authority and a signed transaction. Splitting them keeps this one free, wallet-free and safe to run on any token, including ones you have nothing to do with.
The chain of things that has to be true
A logo in a wallet is four facts, each able to fail on its own: the mint has a metadata URI, that URI returns a JSON document, the document has an image field, and that image loads. Only the name, symbol and URI are on-chain: the rest lives in a JSON file you host, which is why a healthy token can show a blank circle after that file moves.
Fix what you find with Update Metadata, see the rest of what a buyer checks with the Rug Checker, or start fresh from Create a Solana Token.