How to Update Solana Token Metadata (Name, Symbol, Logo)

To update your Solana token's metadata, you need update authority over the token's metadata account. If you retained update authority during token creation, you can change the name, symbol, description, logo, and social links. If update authority was revoked, the metadata is permanently immutable and cannot be changed.

What Is Token Metadata?

Token metadata is the information displayed about your token across the Solana ecosystem — wallets, explorers, DEXs, and analytics platforms. It includes:

• Name — Full display name (e.g., "My Project Token")
• Symbol — Ticker symbol (e.g., "MPT")
• Description — Short description of your token
• Image/Logo — The logo displayed in wallets and on DEXs
• External URL — Link to your project website
• Social links — Twitter, Discord, Telegram links
• URI — Link to the full metadata JSON file (stored on Arweave or IPFS)

For a deep dive, read our Solana Token Metadata Guide.

Can You Update Your Token's Metadata?

It depends on whether you have update authority:

| Scenario | Can Update? | |----------|------------| | You have update authority | Yes — full control over all metadata fields | | Update authority was revoked | No — metadata is permanently immutable | | Update authority transferred to another wallet | Only that wallet can update | | Token created on Pump.fun | Depends on Pump.fun's authority settings | | Token has no metadata account | Need to create one first |

How to check: Look up your token on Solana Explorer or Solscan. Find the metadata account and check the "Update Authority" field. If it shows your wallet address, you can update. If it shows null or a different address, you cannot.

What Can You Update?

With update authority, you can change:

| Field | Updatable? | Notes | |-------|-----------|-------| | Name | Yes | Display name in wallets and explorers | | Symbol | Yes | Ticker on DEXs and charts | | Description | Yes | About text in metadata | | Logo/Image | Yes | Upload new image, update URI | | External URL | Yes | Project website link | | Social links | Yes | Twitter, Discord, Telegram | | Decimals | No | Set at creation, permanent | | Total supply | No (via metadata) | Supply is on the mint account, not metadata | | Mint address | No | The token address is permanent |

How to Update Metadata

Method 1: Using a Token Creator Tool

The easiest way to update metadata is through a no-code tool that supports metadata updates. On SolTokenCreator.io, the token creation interface can update metadata for tokens where you hold update authority.

1. Connect the wallet that holds update authority
2. Enter your token's mint address
3. Modify the fields you want to change
4. Upload a new logo if needed
5. Approve the update transaction

Method 2: Using Metaplex CLI

For technical users, the Metaplex CLI provides direct metadata updates:

metaplex tokens update \
  --mint YOUR_TOKEN_MINT_ADDRESS \
  --name "New Name" \
  --symbol "NEW" \
  --uri "https://arweave.net/your-new-metadata-json"

This requires:

• Metaplex CLI installed
• Solana CLI configured
• Wallet keypair file with update authority

Method 3: Using Metaplex SDK (JavaScript)

For developers building applications:

import { updateV1 } from "@metaplex-foundation/mpl-token-metadata";

await updateV1(umi, {
  mint: publicKey("YOUR_MINT_ADDRESS"),
  data: {
    name: "New Name",
    symbol: "NEW",
    uri: "https://arweave.net/new-metadata.json",
    sellerFeeBasisPoints: 0,
    creators: null,
  },
}).sendAndConfirm(umi);

Updating the Logo/Image

Changing your token's logo requires updating the metadata URI:

1. Upload new image to Arweave, IPFS, or another permanent storage
2. Create new metadata JSON file that points to the new image
3. Upload metadata JSON to permanent storage
4. Update the token's URI field to point to the new metadata JSON

The metadata JSON format:

{
  "name": "Your Token Name",
  "symbol": "SYMBOL",
  "description": "Your token description",
  "image": "https://arweave.net/YOUR_NEW_IMAGE_HASH",
  "external_url": "https://yourproject.com",
  "attributes": [],
  "properties": {
    "files": [
      {
        "uri": "https://arweave.net/YOUR_NEW_IMAGE_HASH",
        "type": "image/png"
      }
    ]
  }
}

Should You Revoke Update Authority?

Revoking update authority makes your token's metadata permanently immutable. This has trade-offs:

Reasons to revoke:

• Proves to the community that the name, symbol, and branding cannot be changed
• Some trust checkers view immutable metadata positively
• Prevents accidental or malicious metadata changes

Reasons to keep:

• Ability to fix typos or improve branding
• Update social links as your project grows
• Change logo for rebranding
• Add or update project description

Our recommendation: Keep update authority until your branding is finalized. Revoke it when you are confident the metadata is exactly right. Unlike mint and freeze authority (which you should revoke immediately for trust), update authority is less critical for security.

Common Metadata Issues

Logo not showing in wallets:

• Ensure the image URL in your metadata JSON is accessible (not behind authentication)
• Use permanent storage (Arweave preferred) — IPFS pins can expire
• Image should be square (at least 256x256 pixels)
• Wallets cache images — changes may take minutes to hours to reflect

Name/symbol not updating on DEXs:

• DexScreener, Jupiter, and other platforms cache token data
• After updating on-chain, allow 1-24 hours for platforms to refresh
• Some platforms may require manual cache clearing (contact their support)

Metadata appears blank:

• Check that your metadata JSON file is properly formatted and accessible
• Verify the URI field points to a valid JSON file
• Ensure the metadata account exists (some tokens created by CLI may not have one)

Related Guides

• Solana Token Metadata Guide — Deep dive into metadata structure
• How to Create a Solana Token — Create with proper metadata from the start
• Verify Token on Explorers — Check your metadata displays correctly
• Token Security Best Practices — Authority management guide