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

1. Upload the image (PNG/JPG/SVG).

2. Create a metadata JSON (see example below) and upload it to IPFS.

3. Copy the metadata URI like ipfs://<CID>/metadata.json.

4. 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)

1. Connect Wallet (must match Update Authority).

2. Select Token you want to edit.

3. Paste the new URI (or edit name/symbol if needed).

4. Preview changes (old vs new).

5. Confirm & Sign the transaction.

6. 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).