deploya tokenTools / Update NFT

Update Solana NFT Metadata

Change an NFT's name, image, royalty rate and creator list, without erasing the fields you did not touch.

Solana0.1 SOL per action

Wallet not connected

Connect your wallet to edit an NFT you created. You sign every action yourself, and nothing is custodial.

How to update Solana NFT metadata

  1. Connect the wallet that holds the NFT's update authority. That is usually the wallet that minted it, and it is not necessarily the wallet holding the NFT today.
  2. Paste the NFT's own mint address and read it. The tool reads the metadata file too, so the form starts from what the NFT already says.
  3. Edit the name, symbol, description or social links, and upload a new image if you want one. The traits are read from the current file and written back untouched.
  4. Set the royalty rate if it needs changing. Two decimal places at most, because on-chain it is stored in hundredths of a percent.
  5. Adjust the creator list if you need to. The shares have to total exactly 100, and a list containing a verified creator cannot be edited at all.
  6. Save and approve the one transaction. We host the new image and metadata file, write its link on-chain, and put back everything you did not touch, including the collection link.
  7. Hosting the metadata file yourself, on IPFS or Arweave? Open Advanced and paste its link instead. What you paste goes on-chain unchanged.

Common questions

Can I change an NFT's picture?

Yes, directly. Upload the new image and save: we host it, rebuild the metadata file around it, and write the new link on-chain. The picture is not on-chain itself, so this is really two steps, but you only do one. If you host the metadata file yourself and would rather keep control of it, Advanced still takes a link you supply.

Will changing the image erase my traits?

No. Traits live in the metadata file, and saving replaces that file rather than editing it, so the tool reads it first and writes every trait back unchanged. It tells you how many it found before you sign. The file list and animation are carried the same way, and if the current file cannot be read at all the tool says so and makes you confirm rather than quietly dropping what was in it.

Will editing the name erase my royalties?

No, and that is the reason this tool exists. The Metaplex instruction underneath replaces the whole metadata record rather than patching one field, so anything not restated is erased. This tool reads the current values first and writes back every field you did not touch, including the royalty rate, the creator list and the collection link.

Can I move an NFT into a collection, or out of one?

No. Setting or verifying a collection is a different instruction, and it needs the collection authority to sign rather than the NFT's update authority. Offering it here would produce a transaction that fails after you had already approved it. The collection link is read, shown and preserved, never rewritten.

Why can I see the creator list but not edit it?

Because one of the creators is verified. A creator verifies themselves by signing, and the program then refuses to let anybody else adjust that entry, including the update authority. The list is displayed so you can check it, and it is preserved exactly as it is by anything you save.

Will marketplaces actually pay the royalty I set?

Some will and some will not. The rate is a number in the metadata, not a rule the chain enforces: nothing about a transfer checks it. Most Solana marketplaces moved to optional or creator-set royalties, so treat this as what you are asking for rather than what you will receive. Setting it correctly still matters, because the marketplaces that do honour it read this field.

Do the creator shares have to add up to 100?

Exactly 100, not up to 100. The program refuses any other total outright, so a list summing to 99 is not a smaller royalty, it is a transaction that fails. The tool adds the shares up as you type and refuses to send until they balance.

Does this work on a collection NFT?

Yes. A collection is itself an NFT with a metadata account, so the same instruction edits it and the tool says so when it detects one. Changing the collection NFT's own name and image is how the collection appears differently in wallets. It does not change the items inside it, which each have their own metadata.

My NFT says it is immutable. Can you unlock it?

No, and neither can anyone else. Immutable is permanent by design: it is the guarantee that an NFT someone bought cannot be swapped for something different afterwards. If the metadata was locked, the name, image, royalties and creators are fixed for good.

It says I am not the update authority. What now?

Only the wallet holding the update authority can edit an NFT, and that is not always the wallet holding the NFT. If you bought it, the creator almost certainly kept the authority. If you minted it through a launchpad, the authority may sit with that platform. The tool shows which address holds it so you can check whether it is one of yours.

Does it work with Token-2022 NFTs?

No, and it refuses one up front rather than failing at the wallet popup. Token-2022 keeps metadata inside the mint rather than in a separate Metaplex account, and that format has no field for a royalty rate or a creator list at all, so there would be nothing here to edit.

Is this the same as the Update Metadata tool?

They write the same account through the same instruction, and they differ in what they let you touch. Update Metadata handles the name, symbol and URI of a fungible token and restates royalties and creators as whatever they already were. This one is the only place those two are editable, which keeps the number of screens that can change who gets paid at exactly one.

How long until my wallet shows the change?

The chain has it as soon as the transaction confirms. Wallets, explorers and marketplaces cache metadata and refresh on their own schedules, so a few minutes is normal and some marketplaces have a manual refresh button on the item's page.

What this tool is for

An NFT's name, image, royalty rate and creator list all live in one small on-chain account. This edits that account. The usual reasons are ordinary: a typo in a name, an image link that has rotted, a royalty rate set wrong at mint, or a collaborator who should be on the royalty split and is not.

The bug this tool was written around

Worth explaining, because it is the whole reason this is a separate page. The Metaplex instruction that updates metadata does not patch individual fields. Its argument replaces the entire record, so any field the caller does not restate is not left alone, it is erased.

On a plain token that is harmless, because the royalty rate and creator list are empty there anyway. On an NFT it is destructive: fixing a typo in the name can zero the royalty rate, delete the list of people the royalty is paid to, and unlink the NFT from its collection. This tool reads the current values before it writes and carries through everything you did not touch, and so does Update Metadata, which shares the same code for it.

Where the picture actually lives

Only a link is on-chain. The metadata URI points at a JSON file, and that file names the image, the description and every trait. Upload a new image above and the tool does both halves: it hosts the picture, rebuilds that JSON file around it, and writes the new link on-chain in the transaction you approve.

Rebuilding the file is the part worth understanding, because it is where an NFT can quietly lose everything that makes it one. The new file is written whole, not patched, so the tool reads the old one first and carries the traits, the file list and the animation through untouched. It counts the traits on screen before you sign, and if the old file cannot be read it refuses to guess: you are told, and you have to confirm before anything replaces it.

If you host the metadata file yourself, on IPFS or Arweave or your own server, Advanced takes the link directly and leaves the file alone.

Royalties, honestly

The royalty rate is a number sitting in the metadata. Nothing about a transfer on Solana consults it, and enforcement was always something marketplaces chose to do rather than something the chain did. Most of them now treat royalties as optional or let the buyer decide.

That is not a reason to leave it wrong. The marketplaces that do honour royalties read exactly this field, and so do the aggregators that display a collection's terms. It is a reason not to promise a collaborator a percentage of every future sale on the strength of a number in a form.

Two things this cannot do

  • Move an NFT between collections. That needs the collection authority to sign a different instruction. The link is shown and preserved here, never rewritten.
  • Edit a verified creator. A creator confirms their own involvement by signing, and the program will not let anyone else touch that entry afterwards. A list containing one is read-only.

Related tools

Sources