Help & Troubleshooting
Token Metadata Not Updating
Updated your Solana token metadata but changes aren't showing in wallets or explorers? Learn about metadata caching and how to fix it.
Problem
Updated metadata (name, logo, description) is not reflecting in wallets or explorers.
Quick Solution
Metadata changes can take 5-15 minutes to propagate due to caching. Verify on Solscan that the metadata URI points to the correct JSON file. If metadata is immutable, it cannot be changed.
Why Metadata Updates Are Delayed
Wallets and explorers cache token metadata to improve performance. When you update metadata, the on-chain pointer changes immediately, but cached versions take time to refresh.
Propagation Timeline
- 5-10 minutes
- 10-30 minutes
- 15-60 minutes
- May require manual update via their claim process
How to Verify Updates
1. Go to Solscan.io and search your mint address
2. Click on the metadata account
3. Check that the URI points to your updated JSON file
4. Open the URI in a browser to verify the JSON content is correct
Common Issues
Metadata Is Immutable
If you set metadata as immutable during creation, it CANNOT be changed. This is permanent. You would need to create a new token.
Wrong Authority
Only the update authority can modify metadata. Verify you are connected with the wallet that holds update authority.
JSON File Not Updated
The on-chain metadata points to an off-chain JSON file. Make sure:
- The JSON file at the URI has been updated
- The JSON format is correct
- The image URL in the JSON is accessible
Force Refresh
- **Phantom** — Pull down to refresh, or restart the app
- **Solflare** — Close and reopen the app
- **Browser** — Clear cache or use incognito mode