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

  1. Create a complete test token on Devnet.
  2. Open the resulting metadata URI directly in a browser.
  3. Confirm the document contains the intended name, symbol, description, and image URL.
  4. Open the image URL independently and confirm that it is public.
  5. Compare the displayed mint address with the one returned by the transaction.
  6. 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.

Keep the mint address primary. A name or logo can be copied by someone else. Publish the exact mint address on the official project website so users have an independent reference.

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.

Prepare and test token metadata