deploya tokenTools / Update Metadata

Update Solana Token Metadata

Change the name, symbol and logo wallets show for your token, or lock them permanently.

Solana0.1 SOL per action

Wallet not connected

Connect your wallet to edit your token's name, symbol and logo. You sign every action yourself, and nothing is custodial.

How to update Solana token metadata

  1. Connect the wallet holding the update authority. Only that wallet can change a token's metadata, and if the metadata is already locked nobody can.
  2. Paste the mint address, or pick the token from the recent list. We read what the token says now and fill the form in with it.
  3. Edit the name, symbol or description, upload a new logo, and open Social links to set your website, X, Telegram and Discord. Name and symbol are written on-chain and have length limits the form enforces for you.
  4. Save, and approve the one transaction in your wallet. We host the new logo and metadata file, then write its link on-chain for you.
  5. Give wallets and explorers time. They cache metadata on their own schedule, so a change can take minutes to show up.
  6. Hosting the metadata file yourself, on IPFS or Arweave? Open Advanced and paste its link instead. What you paste goes on-chain unchanged.
  7. Lock the metadata only when you are certain. That step is permanent and no correction is possible afterwards.

Common questions

Why has my new logo not appeared yet?

Almost always caching rather than a failed transaction. Wallets and explorers store metadata and refresh it on their own schedule, so a correct change can take minutes to appear and different apps will update at different times. Check the transaction confirmed on an explorer, then wait before changing anything else.

Where is my token's logo actually stored?

Not on-chain. What is on-chain is the name, the symbol and a metadata URI. That URI points at a JSON file which contains the description and the image link. Upload a logo here and we host both that image and that file for you, and put the link on-chain. This is also why a logo can vanish while the token is perfectly fine: if the file it points at moves or goes offline, wallets have nothing to show.

Can I change just the logo and leave everything else?

Yes. We read your current metadata file first and fill the whole form in with it, so the fields you do not touch are saved back exactly as they were. That matters because saving replaces the file rather than editing it: what you see on screen is what gets written. If we cannot read your current file, the tool says so and makes you confirm before you sign, instead of quietly dropping what was in it.

Can I add my website and social links?

Yes, under Social links: website, X, Telegram and Discord. A full URL or a bare handle both work, and clearing a field removes that link. Explorers like Solscan and Birdeye read them out of your metadata file and show them next to your token, which is one of the cheapest signals that a project is real.

What does locking the metadata do?

It makes the token immutable: the name, symbol and URI can never be changed again by anyone, including us and including you. It is the metadata equivalent of revoking the mint authority, and buyers read it the same way, because an unlocked token can be renamed into something it is not after people have bought it.

Can I change my token's name after launch?

Yes, for as long as you still hold the update authority and the metadata is not locked. Rebranding a live token is normal. Be aware that the change is public and that anyone watching can see the old name, so it is better announced than discovered.

Can I change the supply or the decimals here?

No. Decimals are fixed at creation and can never change. Supply is changed with the Mint and Burn tool, not this one. This page only affects how your token is presented: its name, symbol, logo and description.

Someone else deployed my token. Can I update it?

Only if the update authority was transferred to your wallet. Metadata can be changed by exactly one address, and if that is not you then nothing here will work no matter what else you control. The Rug Checker shows which address currently holds it.

Two places, one identity

Solana token metadata is split across two locations, and almost every confusion about logos comes from not knowing which is which.

  • On-chain, through Metaplex: the name, the symbol, and a URI. These are permanent records changed only by a transaction.
  • Off-chain, at that URI: a JSON file holding the description and the image link. Somebody has to host this, and nothing about it is guaranteed by the chain.

The form above hides that split rather than making you learn it: type a description, upload a logo, and we build the file, host it, and write the link on-chain in the same transaction that saves your name and symbol. If you would rather host the file yourself, on IPFS or Arweave or your own server, Advanced takes the link directly.

The practical consequence of the split is worth knowing either way: your token can be in perfect health while its logo is missing everywhere, because the file the chain points at has moved or gone offline. Host it somewhere durable, and do not use a URL you might tidy up later.

Locking, and why buyers look for it

An unlocked token can be renamed. That sounds harmless until you picture the version where it is not: a token bought under one name and quietly rewritten into a different one, with the same mint address and the same holders. Locking closes that off permanently, which is why our Rug Checker reports metadata mutability as a finding.

The tradeoff is real, so decide rather than default. Locked means you can never fix a typo, never upgrade the artwork, never move the logo to a new host. Most projects lock once the branding has settled, not on day one.

Getting it right the first time

Check the spelling of the name and symbol, and check that the logo preview beside the upload box is actually your image. If you pasted your own metadata URI under Advanced, open it in a browser first to confirm it returns JSON rather than an error page, and that the image link inside it loads on its own. Do it on Testnet with a practice token if this is your first time, then repeat on mainnet. There is no undo on the locking step, and a locked typo is permanent.

Related tools

  • Give up the mint or freeze authority with Revoke Authorities.
  • See what a buyer sees, including who holds the update authority, with the Rug Checker.
  • Starting from scratch? The deploy console writes metadata as part of creating the token.

Sources