How to Check the Metadata of a Coin and Fix Its Logo

How to check the metadata of a coin on Solana: where name, symbol and logo live, how to read them on an explorer, and why a token logo is not showing.

By Solana Token Creator ·

A token's name, ticker and logo are not part of the token itself. They are metadata, stored in a separate place that wallets and explorers look up. When that lookup fails, the token shows as "Unknown" with a blank icon. This guide explains how to check the metadata of a coin on Solana without writing code, what each field means, and why a logo goes missing. If you have not made your token yet, you can create a token with logo and metadata in one transaction and skip most of these problems.

What token metadata holds

Solana token metadata comes in two layers, one on-chain and one in a file it points to.

On-chain: name, symbol and a link

  • Name, up to 32 bytes.
  • Symbol (the ticker), up to 10 bytes.
  • URI, a link of up to 200 bytes to a JSON file.
  • Update authority, the wallet allowed to change the three fields above, or none if it was revoked.

The limits are in bytes, not letters: an accented letter takes two. That is why a creator form may reject a 32-character name that contains one.

Off-chain: the JSON file

The URI points to a small JSON file that carries everything too large for the chain. For a fungible token the fields wallets care about are name, symbol, description and image, the link to the logo. Files made by our creator also list the logo under properties.files with its type, any tags as attributes, and your website and social links under properties.extensions.

So the logo is two hops away from the token: mint, then metadata account, then JSON file, then image. A break at any hop means no logo.

Where metadata lives on Solana

Classic SPL tokens: a Metaplex account

Most tokens use the original token program, which has no room for a name. Their metadata sits in an account owned by the Metaplex Token Metadata program, at an address derived from the mint, so any app can find it from the mint address alone. Phantom's documentation says it looks at this program first, and that it prefers the on-chain name and symbol over the copies in the JSON file. That account also stores a token standard; ours is always set to fungible, so the token lands with your other tokens rather than among collectibles.

Token-2022 tokens: inside the mint

Token-2022 can keep metadata in the mint account itself, through two extensions: a metadata pointer that says where the metadata is, and a token metadata extension holding name, symbol, URI and update authority. Tax tokens from our Tax Token Creator work this way, with the pointer aimed at the mint, so there is no separate account and no Metaplex fee. Our guide to SPL vs Token-2022 covers the two programs side by side.

The JSON and the image: wherever the creator put them

The chain stores only the link, so the file and logo live wherever the token's creator uploaded them: Arweave, IPFS, or an ordinary web server. This choice decides whether the logo still loads in a year. Our creator stores both on Arweave, which is paid once and kept permanently, and links them through a gateway that serves new uploads within seconds.

How to check the metadata of a coin on Solana

You need only the mint address, the token's own address (not a wallet or a pool). Get it from the creator's success screen, the project's site, or the token page of a DEX or tracker. Then:

  1. Open an explorer such as Solscan or Solana Explorer and paste the mint address into the search box.
  2. On the token page, check the name, symbol and logo in the header. If they show, the on-chain metadata and the image link both work.
  3. Find the metadata section (Solscan shows it as a Metadata tab). It lists the on-chain fields: name, symbol, the URI, whether the metadata is mutable and the update authority.
  4. Open the URI in a new browser tab. You should see a short JSON file. Check that its image field is there and holds a full link.
  5. Open the image link. It should load the logo directly, not a web page, an error or a login screen.
  6. Note the update authority. An address means someone can still change the metadata; an empty value, "N/A" or an immutable flag means nobody can.

Six checks, and you know the whole chain from mint to logo. Whichever step fails tells you exactly what to fix.

How to get token metadata in code

Developers can do the same lookup programmatically: derive the Metaplex metadata address from the mint (or read the mint's own extensions for Token-2022), decode name, symbol and URI, then fetch the URI. Many RPC providers also offer a digital asset API that returns the decoded fields and the JSON contents in a single call. For a one-off check, the explorer is faster.

What to look for when you check

What you seeWhat it means
No name or symbol at allThe token has no metadata account, or a Token-2022 mint has no metadata.
Name shows, logo blankThe URI or the image link inside it is broken, slow or not an image.
URI opens a 404 or times outThe file was deleted, never pinned, or its host is down.
Metadata is mutableThe update authority can still rename the token or swap the logo.
Name looks like a famous projectAnyone can pick any name. Trust the mint address, never the name.

The last row matters for buyers. Two tokens can share a name, ticker and even logo. Only the mint address is unique, so always confirm it from the project's own channels before buying.

Why is my Solana token logo not showing?

Work through these in order. The first four cover nearly every case.

1. The token has no metadata

A token made with the bare command-line tools has a mint and nothing else. Wallets show it as unknown. The fix is to create the metadata account, which needs the mint authority, so it is impossible once mint authority is revoked. That is why a creator that writes metadata in the same transaction as the mint is the safer route.

2. The image host is dead or slow

If the URI or the image points to a free file host, a personal server or an IPFS file nobody keeps pinned, the logo disappears when that host does. Public IPFS gateways can also take several seconds to answer, and some wallets give up first. Permanent storage avoids both problems.

3. The image is too big or an odd format

Wallets draw logos at roughly 40 to 100 pixels. A 5 MB original makes every wallet and indexer download the whole file first, and some skip it. Our creator accepts PNG, JPG, WebP or SVG and shrinks every logo in your browser to at most 512 pixels and 100 KB, saved as PNG or JPEG, the two formats every wallet reads.

4. The wallet or tracker has not caught up

A brand-new token may show without a logo for a few minutes. Wallets, explorers and trackers keep their own caches and pick new tokens up on their own schedule. Refresh, wait, and try another wallet before changing anything.

5. The wallet hid the token as possible spam

Phantom runs trust and safety checks that can hide a token or show it with a warning, using its own systems and outside providers such as Blockaid. The criteria are not published. Complete metadata and recognition by registries such as CoinGecko and Jupiter help. If a legitimate token is flagged, Phantom's docs point to an appeal through Blockaid and then Phantom support.

6. Solscan shows its own data

Explorers can show a logo and links from their own records as well as from the chain, and Solscan labels new tokens by reputation. Solscan offers a request form for projects to update the logo and links it displays, but it cannot change your on-chain metadata. Fix the metadata first; the explorer listing is a separate step.

Can I change the logo later?

Only if the update authority still exists. The wallet that holds it can sign a metadata update that points the URI at a new JSON file with a new image. On classic tokens that is a Metaplex update instruction; on Token-2022 it is the token metadata extension's own update. This site has no metadata update tool, so you would use a Metaplex-compatible tool or a script signed by that wallet. If you revoked update authority at creation, for 0.04 SOL in our creator, the metadata is fixed forever, which is exactly why buyers like it. Our guide to update authority weighs keeping it against giving it up.

Frequently asked questions

How do I see a token's metadata?

Paste the mint address into Solscan or Solana Explorer, open the metadata section, then open the URI it lists to read the JSON file and its image link.

Where is a Solana token's logo stored?

Off-chain, at the link in the token's metadata file. Only the link to that file is on the chain. Tokens from our creator keep both files on Arweave.

Does Phantom need to verify my token?

No. Phantom detects SPL and Token-2022 tokens on its own and reads their metadata. Prices appear once a price source such as CoinGecko or Birdeye has the token, and a spam flag is a separate check.

Why does my token show as "Unknown"?

The wallet found no metadata for the mint. Either none was created, or you are looking at a different address than you think.

Can I add a logo to a token that already exists?

Yes, if you still hold the update authority, or the mint authority when no metadata account exists yet. With both revoked, no one can.

Get it right at creation

Most logo problems start at creation: no metadata, a temporary host or an oversized image. Our creator writes the name, symbol and link in the same transaction as the mint, uploads the logo and JSON to Arweave only after you confirm the review, and costs 0.1 SOL plus any revokes you choose. Open the Solana token creator to start, or read the step-by-step guide to create a Solana token first. Once it is live, the launch checklist covers what to check next.

Ready to use the Token Creator?

Connect your wallet, fill in the form and review every value and fee before you sign.