How to Add a Logo to Your Solana Token — Complete Guide (2026)

To add a logo to your Solana token, include it during token creation at SolTokenCreator.io, or update the metadata afterward using the metadata manager. The logo is stored in a metadata JSON file on decentralized storage (IPFS or Arweave) and linked to your token's on-chain metadata account. Once set, the logo appears automatically in wallets, DEXs, and explorers.

How Token Logos Work on Solana

Solana token logos are stored through the Metaplex metadata standard:

1. Your logo image is uploaded to decentralized storage (IPFS or Arweave)
2. A metadata JSON file is created containing the image URL, token name, symbol, and description
3. The JSON file URL is stored in your token's on-chain metadata account
4. Wallets and DEXs read the metadata account, fetch the JSON, and display the logo

This is why your logo appears across all platforms simultaneously — they all read from the same on-chain metadata.

Adding a Logo During Token Creation

The easiest way to add a logo is during initial token creation:

1. Go to SolTokenCreator.io
2. Connect your wallet
3. Fill in token details (name, symbol, supply, decimals)
4. Upload your logo image in the logo field
5. Add description and social links
6. Create token — the logo is included in the metadata automatically

SolTokenCreator handles the image upload, JSON generation, and on-chain metadata creation in one transaction.

Logo Requirements

Image Specifications

| Requirement | Recommended | Minimum | |------------|-------------|---------| | Format | PNG (transparent background) | PNG, JPG, GIF, WebP | | Size | 512x512 pixels | 128x128 pixels | | Aspect ratio | 1:1 (square) | 1:1 (square) | | File size | Under 500KB | Under 2MB | | Background | Transparent or solid color | Any |

Design Best Practices

• Use a square image — Non-square images will be cropped or distorted
• Keep it simple — Logos appear at small sizes (32x32 in wallets)
• High contrast — Ensure the logo is visible on both light and dark backgrounds
• No text-heavy designs — Text becomes unreadable at small display sizes
• Transparent PNG — Looks professional across different UI backgrounds

Updating an Existing Token's Logo

If you created a token without a logo, or want to change the existing one:

Using SolTokenCreator

1. Go to the metadata update tool
2. Connect the wallet that holds update authority
3. Enter your token's mint address
4. Upload the new logo image
5. Update metadata — the new logo replaces the old one

Requirements for Updating

• You must be connected with the wallet that holds update authority
• If update authority has been revoked (metadata is immutable), the logo cannot be changed
• The update transaction costs a small amount of SOL (gas only)

Where Your Logo Appears

Once your metadata is set, the logo displays across the entire Solana ecosystem:

| Platform | Display Size | Update Delay | |----------|-------------|-------------| | Phantom wallet | 32x32 to 64x64 | Minutes to hours (cached) | | Solflare wallet | 32x32 to 64x64 | Minutes to hours | | Jupiter | 24x24 to 48x48 | 5-15 minutes | | DexScreener | 32x32 to 128x128 | 5-15 minutes | | Birdeye | 32x32 to 64x64 | 5-15 minutes | | Solscan | 32x32 to 128x128 | Minutes | | Raydium | 24x24 to 48x48 | 5-15 minutes |

Caching and Delays

Wallets and DEXs cache metadata to improve performance. After updating your logo:

• DexScreener/Birdeye: Usually reflects within 5-15 minutes
• Jupiter: May take up to 15 minutes
• Phantom wallet: Can take hours due to aggressive caching. Try closing and reopening the app
• Solscan: Usually updates within minutes

If your logo is not updating, see our metadata not updating troubleshooting guide.

DexScreener Logo

DexScreener shows your on-chain metadata logo automatically. For enhanced branding:

1. Wait for your token to appear on DexScreener (5-15 minutes after pool creation)
2. Claim your token page through DexScreener's token info update
3. Add official links (website, Twitter, Telegram)
4. Your logo from on-chain metadata displays automatically

Troubleshooting

Logo Not Showing in Wallet

Phantom: Tap the search icon in your token list, paste your token's mint address, and manually add the token. The logo should appear once Phantom fetches the metadata.

Solflare: Similar process — search for the token by mint address and add it.

See Token Not Showing in Wallet for detailed troubleshooting.

Logo Shows on Some Platforms but Not Others

Different platforms cache metadata at different rates. If the logo shows on Solscan but not Phantom:

• Solscan fetches metadata directly (fast)
• Phantom uses a cached metadata service (can be delayed)
• Wait a few hours and restart the wallet app

Logo Quality Looks Bad

• Ensure your image is at least 512x512 pixels
• Use PNG format for best quality
• Avoid JPEG compression artifacts
• Make sure the image is exactly square (1:1 ratio)

Cannot Update Logo

If you get an error when trying to update:

• Verify you are connected with the wallet that holds update authority
• If update authority was revoked, metadata is immutable and cannot be changed
• Check that your token's metadata account exists on Solscan

Metadata Beyond the Logo

Your token's metadata includes more than just the logo:

| Field | What It Is | Example | |-------|-----------|---------| | Name | Full token name | "My Awesome Token" | | Symbol | Short ticker | "MAT" | | Image | Logo URL | IPFS/Arweave URL | | Description | Token description | "A community-driven token..." | | External URL | Project website | "https://mytoken.com" | | Twitter | Social link | "@mytoken" | | Telegram | Community link | "t.me/mytoken" | | Discord | Community link | "discord.gg/mytoken" |

All of these can be set during creation or updated later (if update authority is still active).

Related Guides

• Solana Token Metadata Guide — Complete metadata deep dive
• Update Token Metadata — How to update metadata
• Token Metadata Not Updating — Troubleshooting
• DexScreener Token Info Guide — Claim your DexScreener page
• Token Not Showing in Wallet — Wallet display issues
• Verify Token on Solana Explorer — Explorer verification
• Create Your Token with Logo — Start creating now