Update Metadata
Update your token’s Metaplex Metadata (name, symbol, image/JSON URI, social links, description). This does not change the mint supply or your balances.
Works for SPL and Token-2022 mints (we use Metaplex metadata for best wallet/explorer compatibility).
Most common action: replace uri to point to a new IPFS JSON.
Requirements
Your connected wallet must be the current Update Authority of the token.
The metadata must be mutable (isMutable = true). If it was locked, you cannot edit it.
Your new metadata JSON must be hosted and reachable (IPFS recommended).
Quick IPFS Checklist
Upload the image (PNG/JPG/SVG).
Create a metadata JSON (see example below) and upload it to IPFS.
Copy the metadata URI like ipfs://<CID>/metadata.json.
Use that URI in the app.
Minimal JSON example:
{
"name": "My Token",
"symbol": "MYT",
"description": "Utility token.",
"image": "ipfs://<CID>/image.png",
"external_url": "https://example.com",
"attributes": [{"trait_type":"Category","value":"Utility"}],
"extensions": {
"twitter": "https://x.com/mytoken",
"telegram": "https://t.me/mytoken",
"discord": "https://discord.gg/xxxxx"
}
}How to update (in the app)
Connect Wallet (must match Update Authority).
Select Token you want to edit.
Paste the new URI (or edit name/symbol if needed).
Preview changes (old vs new).
Confirm & Sign the transaction.
Wait a few minutes while wallets/explorers refresh cached metadata.
Tip: Most wallets refresh uri quickly; name/symbol can cache longer.
Common use cases
Change image or text → upload new file(s) to IPFS → update uri only.
Rebrand → update name, symbol, and uri together.
Hand over control → change Update Authority to a team/DAO wallet (then they can update later).
Freeze future edits → set isMutable = false (irreversible).
Troubleshooting
“Update authority is incorrect”
Connect the wallet that currently holds Update Authority (check on Solscan/Explorer).
“Metadata is immutable”
The token’s metadata was locked. It cannot be edited.
New image/JSON doesn’t show
Ensure uri is correct (ipfs://…/metadata.json).
JSON must be valid and publicly accessible.
Give wallets a few minutes to refresh caches.
Name/symbol didn’t change
Some apps cache those fields longer. Try a hard refresh or another wallet/explorer.
Safety & best practices
Keep a secure backup of the Update Authority wallet/keys.
Only lock (isMutable = false) when you’re sure the metadata is final.
Prefer IPFS or another permanent store for durability and decentralization.
Keep your JSON small and clean (avoid huge images, ensure valid JSON).
Last updated